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# Intro 

IYour br3in on Java. Here you are trying to /eam something, while here your bra/n 
is doing you a favor by making sure the learning doesn't stick. Your brain's thinking/'Better 
leave room for more important things, like which wild animals to avoid and whether naked 
snowboarding is a bad idea." So how do you trick your brain into thinking that your life 
depends on knowing Java? 
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Breaking the Surface 



Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1 .02, Java seduced programmers with its friendly syntax, object-oriented 
features, memory management, and best of all — the promise of portability. We'll take a quick 
dip and write some code, compile it, and run it. We're talking syntax, loops, branching, and what 
makes Java so cool. Dive in. 
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A Trip to Objectville 



I was told there would be objects, in chapter 1,we put all of our code 
in the main() method. That's not exactly object-oriented. So now we've got to leave that 
procedural world behind and start making some objects of our own. We'll look at what 
makes object-oriented (00) development in Java so much fun. We'll look at the difference 
between a class and an object. We'll look at how objects can improve your life. 
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Chair Wars (Brad the OO guy vs. Larry the procedural guy) 

Inheritance (an introduction) 

Overriding methods (an introduction) 

What's in a class? (methods, instance variables) 

Making your first object 

Using main() 
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Exercises and puzzles 
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Know Your Variables 

Variables come in two flavors: primitive and reference. 

There's gotta be more to life than integers. Strings, and arrays. What if you have a PetOwner 
object with a Dog instance variable? Or a Car with an Engine? In this chapter we'll unwrap 
the mysteries of Java types and look at what you can declare as a variable, what you can put 
in a variable, and what you can do with a variable. And we'll finally see what life is truly like 
on the garbage-collectible heap. 





Declaring a variable Java cares about type) 

Primitive types ("I'd like a double with extra foam, please" 

Java keywords 

Reference variables (remote control to an object) 
Object declaration and assignment 
Objects on the garbage-collectible heap 
Arrays (a first look) 
Exercises and puzzles 
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How Objects Behave 



state affects behavior, behavior affects state, we know that objects 

have state and behavior, represented by instance variables and methods. Now we'll look 
at how state and behavior are related. An object's behavior uses an object's unique state. 
In other words, methods use instance variable values. Like/'if dog weight is less than 14 
pounds, make yippy sound, else..." Let's go change some state! 



pass-by -value means 
pass-by-co£Y 



int 

foo.go (x); 




Methods use object state (bark different) 
Method arguments and return types 
Pass-by-value (the variable is always copied) 
Getters and Setters 

Encapsulation (do it or risk humiliation) 
Using references in an array 
Exercises and puzzles 
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void go (int z) { } 
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Extra-Strength Methods 

Let's put some muscle in our methods. You dabbled with variables, 
played with a few objects, and wrote a little code. But you need more tools. Like 
operators. And loops. Might be useful to generate random numbers. And turn 

a String into an int, yeah, that would be cool. And why don't we learn it all by building 
something real, to see what it's like to write (and test) a program from scratch. Maybe a 
game, like Sink a Dot Com (similar to Battleship). 



Building the Sink a Dot Com game 96 

Starting with the Simple Dot Com game (a simpler version) 98 

Writing prepcode (pseudocode for the game) 1 00 

Test code for Simple Dot Com 102 

Coding the Simple Dot Com game 103 

Final code for Simple Dot Com 106 

Generating random numbers with Math.random() 111 

Ready-bake code for getting user input from the command-line 112 

Looping with for loops 114 

Casting primitives from a large size to a smaller size 117 

Converting a String to an int with IntegerparselntQ 117 

Exercises and puzzles 118 
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Using the Java Library 

Java ships with hundreds of pre-built classes. You don t have to 

reinvent the wheel if you know how to find what you need from the Java library, commonly 
known as the Java API. You've got better tilings to do. If you're going to write code, you 
might as well write only the parts that are custom for your application. The core Java library 
is a giant pile of classes just waiting for you to use like building blocks. 



"Good to know there's an ArrayList in 
the java.util package. But by myself, how 
would I have figured that out?" 



Julia, 31, hand model 




Analying the bug in the Simple Dot Com Game 

ArrayList (taking advantage of the Java API) 

Fixing the DotCom class code 

Building the real game (Sink a Dot Com) 

Prepcode for the real game 

Code for the real game 
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Using the library Java API) 
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Better Living in Objectviiie 

Plan your programs with the future in mind, what if you could write 

code that someone else could extend, easily? What if you could write code that was flexible, 
for those pesky last-minute spec changes? When you get on the Polymorphism Plan, you'll 
learn the 5 steps to better class design, the 3 tricks to polymorphism, the 8 ways to make 
flexible code, and if you act now — a bonus lesson on the 4 tips for exploiting inheritance. 

^Jva is 

" ^ Understanding inheritance (superclass and subclass relationships) 168 

Designing an inheritance tree (the Animal simulation) 170 

Avoiding duplicate code (using inheritance) 171 

Overriding methods 172 

IS-A and HAS-A (bathtub girl) 1 77 

What do you inherit from your superclass? 1 80 

What does inheritance really buy you? 182 

Polymorphism (using a supertype reference to a subclass object) 183 

Rules for overriding (don't touch those arguments and return types!) 190 

Method overloading (nothing more than method name re-use) 191 

Exercises and puzzles 192 
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Serious Polymorphism 

Inheritance is just the beginning. To exploit poiymorphi Sin, we need 

interfaces. We need to go beyond simple inheritance to flexibility you can get only by 
designing and coding to interfaces. What's an interface? A 100% abstract class. What's an 
abstract class? A class that can't be instantiated. What's that good for? Read the chapter... 



Object o = al.get(id); 
Dog d = (Dog) o; 



d.barkO; 
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Some classes just should not be instantiated 
Abstract classes {can't be instantiated) 
Abstract methods (must be implemented) 
Polymorphism in action 

Glass Object (the ultimate superclass of everything 
Taking objects out of an Array List (they come out as type Object) 
Compiler checks the reference type (before letting you call a method) 
Get in touch with your inner object 
Polymorphic references 

Casting an object reference (moving lower on the inheritance tree) 
Deadly Diamond of Death (multiple inheritance problem) 
Using interfaces (the best solution!) 
Exercises and puzzles 
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Life and Death of an Object 

Objects are born and objects die. You 're in charge. You decide when and 
how to construct therr\.You decide when to abandon them. The Garbage Collector (gc) 

reclaims the memory. We'll look at how objects are created, where they live, and how to 
keep or abandon them efficiently. That means we'll talk about the heap, the stack, scope, 
constructors, super constructors, null references, and gc eligibility. 

The stack and the heap, where objects and variables live 236 

Methods on the stack 237 

Where /o^:^z/ variables live 238 

Where instance variables live 239 

The miracle of object creation 240 

Constructors (the code that runs when you say new) 241 

Initializing the state of a new Duck 243 

Overloaded constructors 247 

Superclass constructors (constructor chaining) 250 

Invoking overloaded constructors using thisQ 256 

Life of an object 258 

Garbage Collection (and making objects eligible) 260 

Exercises and puzzles 266 
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static variables 
are shared by 
all instances of 
a class. 



Numbers Matter 

Do the Math. The Java API has methods for absolute value, rounding, min/max, etc. 
But what about formatting? You might want numbers to print exactly two decimal points, 
or with commas in all the right places. And you might want to print and manipulate dates, 
too. And what about parsing a String into a number? Or turning a number into a String? 
We'll start by learning what it means for a variable or method to be static. 
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Math class (do you really need an instance of it?) 
static methods 
static variables 

Constants (static final variables) 

Math methods (randomQ, round(), abs(), etc.) 

Wrapper classes (Integer, Boolean, Character, etc.) 

Autoboxing 

Number formatting 

Date formatting and manipulation 

Static imports 

Exercises and puzzles 
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Risky Behavior 



stuff happens. The file isn't there.The server is down. No matter how good a 
programmer you are, you can't control everything. When you write a risky method, you need 
code to handle the bad things that might happen. But how do you knowwhen a method is 
risky? Where do you put the code to handle the exceptional situation? In this chapter, we're 
going to build a MIDI Music Player, that uses the risky JavaSound API, so we better find out. 




your code 



class with a 
risky method 



Making a music machine (the BeatBox) 316 

What if you need to call risky code? 319 

Exceptions say "something bad may have happened..." 320 

The compiler guarantees (it checks) that you're aware of the risks 321 

Catching exceptions using a try /catch (skateboarder) 322 

Flow control in try /catch blocks 326 

The finally block (no matter what happens, turn off the oven!) 327 

Catching multiple exceptions (the order matters) 329 

Declaring an exception (just duck it) 335 

Handle or declare law 337 

Code Kitchen (making sounds) 339 

Exercises and puzzles 348 
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class MyOuter { 




class My Inner { 






void go ( ) { 






} 






} 




} 





A Very Graphic Story 



The outer and inner objects 
are now intimately linked. 



Face it, you need to make GUIs. Even if you believe that for the rest of your 
life you'll write only server-side code, sooner or later you'll need to write tools, and you'll 
want a graphical interface. We'll spend two chapters on GUIs, and learn nnore language 
features including Event Handling and Inner Classes. We'll put a button on the screen, 
we'll paint on the screen, we'll display a jpeg image, and we'll even do some animation. 

Your first GUI 355 

Getting a user event 357 

Implement a listener interface 358 

Getting a button's ActionEvent 360 

Putting graphics on a GUI 363 

Fun with paintGomponentQ 365 

The Graphics2D object 366 

Putting more than one button on a screen 370 

Inner classes to the rescue (make your listener an inner class) 376 

Animation (move it, paint it, move it, paint it, move it, paint it...) 382 

Code Kitchen (painting graphics with the beat of the music) 386 

Exercises and puzzles 394 
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Work on your Swing 

Swing is easy, unless you actually care where everything goes. Swing code looks 
easy, but then compile it, run it, look at it and think/'hey, that's not supposed to go there." 
The thing that makes it easy to code is the thing that makes it hard to control — the Layout 
Manager. But with a little work, you can get layout managers to submit to your will. In 
this chapter, we'll work on our Swing and learn more about widgets. 

Swing Components 400 

Layout Managers (they control size and placement) 40 1 

Three Layout Managers (border, flow, box) 403 

BorderLayout (cares about five regions) 404 

FlowLayout (cares about the order and preferred size) 408 

BoxLayout (like flow, but can stack components vertically) 411 

JTextField (for single-line user input) 413 

JTextArea (for multi-line, scrolling text) 414 

JGheckBox (is it selected?) 4 1 6 

JList (a scrollable, selectable list) 4 1 7 

Code Kitchen (The Big One - building the BeatBox chat client) 418 

Exercises and puzzles 424 
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Saving Objects 



Objects can be flattened and inflated, objects have state and behavior. 
Behavior lives in the class, but state lives within each individual object. If your program 
needs to save state, you can do it the hard way, interrogating each object, painstakingly 
writing the value of each instance variable. Or, you can do it the easy 00 way — you simply 
freeze-dry the object (serialize it) and reconstitute (deserialize) it to get it back. 





Saving object state 

Writing a serialized object to a file 

Java input and output streams (connections and chains) 
Object serialization 

Implementing the Serializable interface 
Using transient variables 
Deserializing an object 
Writing to a text file 
java.io.File 

Reading from a text file 

Splitting a String into tokens with splitQ 

GodeKitchen 

Exercises and puzzles 
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Make a Connection 

Connect with the outside world, it's easy, an the low-level networking 
details are taken care of by classes in the java.net library. One of Java's best features is 
that sending and receiving data over a network is really just I/O with a slightly different 
connection stream at the end of the chain. In this chapter we'll make client sockets. We'll 
make server sockets. We'll make clients and servers. Before the chapter's done, you'll have a 
fully-functional, multithreaded chat client. Did we just say multithreaded? 



Client ^ *V\ovN Server 



Ghat program overview 
Connecting, sending, and receiving 
Network sockets 
TCP ports 

Reading data from a socket (using BufferedReader) 
Writing data to a socket (using PrintWriter) 
Writing the Daily Advice Client program 
Writing a simple server 
Daily Advice Server code 
Writing a chat client 
Multiple call stacks 

Launching a new thread (make it, start it) 

The Runnable interface (the thread's job) 

Three states of a new Thread object (new, runnable, running 

The runnable-running loop 

Thread scheduler (it's his decision, not yours) 

Putting a thread to sleep 

Making and starting two threads 

Concurrency issues: can this couple be saved? 

The Ryan and Monica concurrency problem, in code 

Locking to make things atomic 

Every object has a lock 

The dreaded "Lost Update" problem 

Synchronized methods (using a lock) 

Deadlock! 

Multithreaded ChatClient code 
Ready-bake SimpleChatServer 
Exercises and puzzles 
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Data Structures 

Sorting is a snap in Java. You have all the tools for collecting and manipulating 
your data without having to write your own sort algorithms The Java Collections 
Framework has a data structure that should work for virtually anything you'll ever need 
to do. Want to keep a list that you can easily keep adding to? Want to find something by 
name? Want to create a list that automatically takes out all the duplicates? Sort your co- 
workers by the number of times they've stabbed you in the back? 



List 



Set 



Map 




Collections 

Sorting an ArrayList with Collections. sortQ 
Generics and type-safety 

Sorting things that implement the Comparable interface 

Sorting things with a custom Comparator 

The collection API — lists, sets, and maps 

Avoiding duplicates with HashSet 

Overriding hashCodeQ and equalsQ 

HashMap 

Using wildcards for polymorphism 
Exercises and puzzles 
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Release Your Code 

It's time to let go. You wrote your code. You tested your code. You refined your code. 
You told everyone you know that if you never saw a line of code again, that'd be fine. But in 
the end, you've created a work of art. The thing actually runs! But now what? In these final 
two chapters, we'll explore how to organize, package, and deploy your Java code. We'll look 
at local, semi-local, and remote deployment options including executable jars, Java Web 
Start, RMI, and Servlets. Relax. Some of the coolest things in Java are easier than you think. 



MyApp.jor l f 

MyApp.class 




Deployment options 


582 


Keep your source code and class files separate 


584 


Making an executable JAR Java ARchives) 


585 


Running an executable JAR 


586 


Put your classes in a package! 


587 


Packages must have a matching directory structure 


589 


Compiling and running with packages 


590 


Compiling with -d 


591 


Making an executable JAR (with packages) 


592 


Java Web Start JWS) for deployment from the web 


597 


How to make and deploy a JWS application 


600 


Exercises and puzzles 
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Distributed Computing 



Being remote doesn't have to be a bad thing, sure, things are easier 

when all the parts of your application are in one place, in one heap, with one JVM to rule 
them all. But that's not always possible. Or desirable. What if your application handles 
powerful computations? What if your app needs data from a secure database? In this 
chapter, we'll learn to use Java's amazingly simple Remote Method Invocation (RMI). We'll 
also take a quick peek at Servlets, Enterprise Java Beans (EJB) , and Jini. 

Java Remote Method Invocation (RMI), hands-on, very detailed 614 

Servlets (a quick look) 625 

Enterprise JavaBeans (EJB), a very quick look 63 1 

Jini, the best trick of all 632 

Building the really cool universal service browser 636 

The End 648 
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Appendix A 



The final Code Kitchen project, an the code for the full client-server chat 
beat box. Your chance to be a rock star. 




BeatBoxFinal (client code) 
MusicServer (server code) 
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Appendix B 



The Top Ten Things that didn't make it into the bool<. we can t send 

you out into the world just yet. We have a few more things for you, but this is the end of the 
book. And this time we really mean it. 

Top Ten List 660 
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This is NOT a reference 
book. Head First Java is a 
book designed for learning^ 
not an encyclopedia of 
Java facts. 



how to use this 

Who is this book for? 

If you can answer '*y^s'* to aU of these; 

Have you done some programming? 

Do you want to learn Java? 

Do you prefer stimulating dinner party 
conversation to dry, dull, technical 
lectures? 

this book is for you. 



Who should probably back away from this book? 

If you can answer '^yes" to any one of these: 

^ Is your programming background limited 
to HTML only, vi/ith no scripting language 
experience? 

(If you've done anything \vith looping; or if/ then 
logic. youUl do fine mth this book, but HTML 
tagging alone might not be enough.) 

^ Are you a kick-butt C+hk programmer 
looking for a reference booli? 



Are you afraid to try something different? 
Would you rather liave a root c^nai than 
mix stripes witli plaid? Do you believe 
than a technical book cant be serious if 
there's a picture of a duck in the memory 
management section? 

this book is not for you. 
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the intro 



We khow what you're thihkmg. 

"How can this be a serious Java prograKiming book?" 
"What*s with all the graphics?" 
Xan I actually Uam it this wsf?'* 
"Do I smell pLzza?" 




Ahd we know what your bralh is thinking. 

Your brain craves novelty. It's always searching, scanning, waiting for 
something unusual. It was built that way, and it helps you stay alive. 

Today, you're less likely to be a tiger snacL But yotu^ brain's still 
looking. You just never know. 

So what does your brain do with all U^e routine, ordinary, normal 
things you encounter? Everything it canto stop them from 
interfering with the brain s realjoh — recording things that matter. It 
doesn't bother saving the boring things; they never make it past the 
"this is obviotxsly not important" filter 

How does your brain know whin's important^ Suppose you're out for 
a day hike and a tiger jumps in front of you, what happens inside your 
head? 

Neurons fire. Emotions crank up. Ourmuals surge. 

And that's how your brain kno^vs... 

This must be Importantt Don't forget Itl 

But imagine you're at home, or in a library. It's a safe, warm, tiger-free 
zone. You're studying. Getting ready for an exam. Or trying to learn 
some cough technical topic your boss thinks \vill lake a week, ten days 
at the mosL 

Just one problem. Your brain's trying Lo do you a big favor. It's 
trying to make sure that this odiously non-important content 
doesn't clutter up scarce resources. Resources that are better 
spent storing the really things. Like tigers. Like the danger of 
fire. Like how you should never again snowboard in shorts. 

And there's no simple way to tell yoiu- brain, "Hey brain, thank 
you very much, btu no matter how dull this book is, and how 
litde Tm registering on the emotional richter scale right now, I 
really ^io want you to keep this stuff around." 




1. :vm tW^*^^ 
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how to use this book 



We texk of a '^eaH First Java" reader as a learner. 

So what does It take to learn something? First, you have to get It, then make sure 
you don't forget \t It's not about pushing facts Into your head. Based on the 
latest research In cognitive science, neurobiology, and educational psychology, 
learning takes a lot more than text on a page. We know what turns your brain on. 





Somo of the Hoad First learning principles: 

Make It visual. Images are far more memorable than words 
alone, and make learning much more effective (Up to 89% 
Improvement in recall and transfer studies). It also makes 
things more understandable. Put the words within 
or near the graphics they relate to, rather than on the 
bottom or on another page, and learners will be up to twice 
as likely to solve problems related to the content. 

Use a conversational and personalized style. In recent studies, 

students performed up to 40% better on post-learning tests if the content spoke 
directly to the reader, using a first-person, conversational style rather than 
taking a formal tone. Tell stories instead of lecturing. Use casual language. Don't 
take yourself too seriously. Which would you pay more attention to: a stimulating 
dinner party companion, or a lecture? 




Get the learner to think more deeply, in other words, unless 
you actively flex your neurons, nothing much happens in your head. 
A reader has to be motivated, engaged, curious, and inspired to 
solve problems, draw conclusions, and generate new knowledge. 

And for that you need challenges, exercises, and thought- 
foam ( ) ; provoking questions, and activities that involve both sides 
^ A of the brain, and multiple senses. 

^ Get--and keep-^he reader's attention. WeVe all 

had the 'I really want to learn this but I can't stay awake past 
page one' experience. Your brain pays attention to things that are out 
of the ordinary, interesting, strange, eye-catching, unexpected. Learning a new, 
tough, technical topic doesn't have to be boring. Your brain will learn much more quickly if it's not. 




Touch their emotions. We now know that your ability to remember something Is largely 
dependent on Its emotional content You remember what you care about You remember when 
you feel something. No we're not talking heart -wrenching stories about a boy and his dog. 
We're talking emotions like surprise, curiosity, fun/what the...?* , and the feeling of 'I Rulel' 
that comes when you solve a puzzle, learn something everybody else thinks Is hard, or realize 
you know something that'Tm more technical than thou" Bob from engineering doesn't. 

>w'v into 




MetacognitioH: thihklHg about thinking. 



Kyou really want to learn, and you want to learn more qiiickly and more deeply, 
pay attention to how you pay attention. Think about how you tJiink. Learn how 
you learn. 

Most of us did not take courses on nnetacognition or learning theory when we were 
growing up. We were expected to kam, but rarely tau^t to learn. 

But we assume that if youVe holding this book, you want to learn Java. And you 
probably don*t want to spend a lot of time. 

To get the most from this book, or any book or learning experience, take 
responsibility for your brain. Your brain on that content. 

Tlie trick is to get your brain to see the new material you're learning 
as Really Important. Crucial to your well-being. As important as 
a tiger. Othenvise, you're in for a constant battle, with your brain 
doing its best to keep die ne\v content from sticking. 



So Just how DO you get your brain to treat Java like It 
was a hungry tiger? 

There's the slow, tedious way, or tine faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are 
able to )eam and remember even the dullest of topics, if you keep pounding 
on the same thing. With enough repetition, your brain says, ^'Tbis doesn*t feel 
important to him, but he keeps looking at the same thing Cfverznd m/^and over, so 
I suppose it must be.** 

The faster way is to do anything that irwreases brain ctctiviiy, especially different types 
of brain activity. The things on the previous page are a big part of the solution, 
and they're all things that have been proven to help your brain work in your favor 
For example^ studies show that putting words within the pictures they describe (as 
opposed to somewhere else in the page, like a caption or in the body text) causes 
your brain to try to makes sense of how the words and picture relate, and this 
ouses more neurons to fire. More neurons firing = more chances for your brain 
to get that this is somediing wortii paying attention to, and possibly recording. 

A conversational style helps because people tend to pay more attention when they 
perceive that they're jn a conversation, since they're expected to follow along and 
hold up their end. The amazing thing is, your brain doesn't necessarily care that 
the conversation** is between you and a book! On the other hand, if the writing 
style is formal and dry, your brain perceives it the same way you experience being 
lectured to while sitting in a roomftil of passive attendees. No need to stay awake. 

But pictures and conversational style are just the beginning. 
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Here's what WE did: 

We used pictures, because your brain is tuned for visuals, not text As £^ as your 
brain*s concerned, a picture really ty worth 1024 words. And when text and pictures 
work together, we embedded the text in the pictiu*es because your brain works 
more effecdvely when the text is vnihin the thing the text refers to, as opposed to in 
a caption or buried in the text somewhere. 

We used repetiium, saying the same thing in different ways and with different media 
types, and multipU senses, to increase the chance that the content gets coded coded 
into more than one area of your brain. 

We used concepts and pictures in unexpected \r2c^ because your brain is tuned for 
novelty, and we used pictures and ideas with at least some etnotumal content^ because 
your brain is tuned to pay attention to the biochemistry of emotions. That which 
causes you to /^/something is more likely to be remembered, even if that feehng is 
nothing more than a litUe humor, surprise, or interest 

We used a personalized, anwersational style^ because your brain is tuned to pay more 
attention when it believes youVe in a conversation than if it thinks you Ye passively 
listening to a presentation. Your brain does this even when you're reading. 

We included more than 50 exercises , because your brain is tuned to learn and 
remember more when you do things than when you tko^^ about things. And we 
made the exercises challenging-yet-do-able, because that's what most people prefer 

We used multiple learmng styles, because you nught prefer step^y-5tep procedures, 
while someone ebe wants to understand the big picture first, while someone else 
just wants to see a code example. But regardless of yoiir own learning preference, 
everyone benefits from seeing the same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can 
stay focused. Since working one side of the brain often means giving the other side 
a chance to rest, you can be more productive at learning for a longer period of 
time. 

And we included itones and exercises that present more ^um ome point of view^ 
because your brain is tuned to learn more deeply when it's forced to make 
evaluations and judgements. 

We included diaUenges, with exercises, and by asking questions that don*t always have 
a straight answer, because your brain is tuned to learn and remember when it has 
to work at something (just as you can't get your body in shape by watching people 
at the gym). But we did our best to make sure that when you're working hard, it's 
on the right things. Th2L\you*re not spending one extra dendrite processing a hard-to- 
understand example, or parsing difficult, jargon-laden, or extremely terse text. 

We used an SO/20 approach. We assume that if you're going for a PhD in Java, 
this won't be your only book. So we don't talk about every thing. Just the stuff you'll 
actually use. 
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Here's what YOU can do to bend your 
brain into submissioh. 

SOi we did our part The rest is up to you. These tips are a 
starting point; Listen to your brain and figure out what works 
for you and what doesn't Try new things. 
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^ Slow down. Tho more you understand, 
the less you have to memorize. 

Don'tjust read. Stop and think. When the 
book asks you a question, don't just skip to 
the answer. Imagine that someone really is 
asking the question. The nr\ore deeply you 
force your brain to think, the better chance 
you have of learning and remembering. 

^ Do the exercises. Write your own notes. 

We put them in, but if we did them for you, 
that would be hke having someone else 
do your workouts for you. And don't just 
lock at the exercises. Use a pencil. There's 
plenty of evidence that physical activity 
y^hile learning can increase the learning. 

Read the ^here are No Dumb Questions" 

That means all of them. They're not 
optional side-bars — diey're part of the core 
content! Sometimes die questions are more 
useful than the answers. 

Dont do all your reading In one place. 

Stand-up, stretch, move aroimd, change 
chairs, change rooms. It'll help your brain 
/f^Z something, and keeps your learning from 
being too connected to a particular place. 

^ Make this the last thing you read before 
bed. Or at least the last challenging thing. 

Part of the learning {especially the transfer 
to long-term memory) happens after you put 
the book down. Your brain needs time on 
its own, to do more processing. If yon put in 
something new during that processing-time, 
some of what you just learned will be lost. 



Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you 
ever feel thirsty) decreases cognitive function. 

Talk about it. Out loud. 

Speaking activates a different part of 
the brain. If you're trying to understand 
somethings or increase your chance of 
remembering it later, say it out loud. Better 
suU, try to explain it out loud to someone 
else. You*ll learn more quickly, and you might 
uncover ideas you hadn't known were there 
when you were reading about it. 

Listen to your brain* 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
tl^e surface or forget what you just read, it*s 
time for a break. Once you go past a certain 
point, you won't learn faster by trying to shove 
more in, and you might even hurt d^e process. 

Feel something! 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad 
joke is still better than feeling nothing at alK 

Type and run the code. 

Type and nm the code examples. Then you 
can experiment with changing and improving 
the code (or breaking it, which is somedmes 
the best way to figure out what's really 
happening). For long examples or Ready-bake 
code, you can dovmload d^e source files from 
headfirstjavaxom 
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how to use this book 

What you need for this boolc: 

You do not need any other development toolj such as an Integrated 
Development Environment (IDE). We strongly recommend that you not 
use anything but a basic text editor until you complete diis book (and 
especudly not until after chapter 16). An IDE can protect you from some of 
the details that really matter, so you're much bcaer off learning from the 
command-line and then, once you really understand what's happening, 
move to a tool that automates some of the process. 

I SEHING UP JAVA 

■ If you don't already have a 1 .5 or greater Java 2 Standard Edition SDK (Software 
Development Kit), you need it. If you're on Linux. Windows, or Solaris, you can get it for free 
from java.sun,com (Sun's mbsWe for Java developers), tt usually takes no more than two clicks 
from the main page to get to the J2SE downloads page. Get the latest non-beta version posted. 
The SDK includes everything you need to compile and run Java. 

If you're running Mac OS X 10.4, the Java SDK is already installed. Ifs part of OS X, and you 
don't have to do anything else. If you're on an earlier version of OS X, you have an earlier 
version of Java that will worlc for 95% of the code in this book. 
Note: This book is based on Java 1 .5, but for stunningly unclear marlceting reasons, shortly 
before release, Sun renamed It Java 5, while still keeping '1 .5" as the version number for the 
developer's kit So, if you see Java 1.5 or Java 5 or Java 5.0, or Tiger' (version 5's original 
code-name), they all mean the same thing. There was never a Java 3.0 or 4.0— it jumped from 
version 1 A to 5.0, but you will still find places where ifs called 1 .5 instead of 5. Don't ask. 
(Oh, and just to make it more entertaining, Java 5 and the Mac OS X 10.4 were both given the 
same code-name of "nger", and since OS X 10.4 is the version of the Mac OS you need to run 
Java 6, you'll hear people talk about Hlger on Tiger". It just means Java 5 on OS X 10,4). 

■ The SDK does not include tiie API documentation, and you need that! Go back to java.sun. 
com and get the J2SE APf documentation. You can also access the API docs online, wHhout 
downloading them, but that's a pain, Tmst us, ifs worth the download. 

■ You need a text editor. Virtually any text editor will do (vi, emacs, pico), including the GUI ones 
that come with most operating systems. Notepad, Wordpad, TextEdit etc. all work, as long as 
you make sure they don't append a ".bcT on to the end of your source code. 

■ Once you've downloaded and unpacked/zipped/whatever (depends on which version and for 
which OS), you need to add an entry to your PATH environment variable Uiat points to the /bin 
directory inside the main Java directory. For example, if the J2SDK puts a directory on your 
drive called ''j2sdk1 .5,0', look inside that directory and you'll find the "bin" directory where the 
Java binaries (tiie tools) live. Tha bin directory is the one you need a PATH to, so that when you 
type: 

% javac 

at the command-line, your terminal will know how to find the javac compiler. 

Note: if you have ti-ouble with you installation, we recommend you go to javaranch.com, and join 

the Java-Beginning forum! Actually, you should do that whetiier you have trouble or not. 



Note: much of Ui© code from this book Is available at wlcke6lysmart.com 
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Last-minute thii^gs you need to know: 

This is a learning experience, not a reference book. We deliberately 
stripped out everything that might get in the way of learning wh2iieweT it 
is we're working on at that point in the book. And the first time through, 
you need to begin at the beginning, because the book makes assumptions 
about whatyou*ve aJready seen and learned. 

We use simple U ML-f fke diagrams. 

If we'd used pureVML, you'd be seeing something that like Java, but 
vnth syntax that's just plain turmig. So we use a simplified version of UML 
that doesn't conflict with Java syntax. If you don't aheady know UML, you 
won't have to worry about leamingjava and UML at the same dme. 

We dont worry about organizing and packaging your own 
code until the end of the book. 

In this book, you can get on with the business of leamingjava, without 
stressing over some of the organizational or administrative details of 
developingjava programs. You willy in the real world, need to know — and 
use — these details, so we cover them in depth. But we save them for the end 
of the book {chapter 17). Relate while you ease into Java, gentiy 

The end-of-chapter exercises are mandatory; puzzles are 
optional. Answers for both are at the end of each chapter. 

One thing you need to know about the ptizzJes — Ihey 're pmxles. As in logic 
' puzzles, brain teasers, crossword puzzles, etc. The txmriseszj^ here to help 
you practice what you Ve learned, and you should do them aJI. The puzzles 
are a different story, and some of them are quite challenging in a pvunJie 
way These ptizzles are meant for puzzlerSy and you probably already know if 
you are one. If you*re not sure, we suggest you give some of them a try, but 
whatever happens, don't be discouraged if you can*i solve a puzzle or if you 
I simply can't be bothered to take the time to work them out. 

The 'Sharpen Your Pencir exercises dont have answers. 

I^ot printed in the book, anyway. For some of them, there is no right 
-toswer, and for the others, part of the learning experience for the Sharpen 
activities is (or you to decide if and when your answers are righL (Some of 
our suggested answers are available on wickedJysman.com) 

[The code examples are as lean as possible 

It's frustrating to wade through 200 lines of code looking for the two lines 
you need to understand. Most examples in this book are shown within the 
I smallest possible context, so that the pan youVe trying to learn is clear and 
simple. So don't expect the code to be robust, or even complete. That's 
w>ur assignment for after you finish the book- The book examples are 
written specifically for learning, and aren't always fully-functional. 
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tech editing: Jessica and Valentin 



Technical Editors 



^'Credit goes to all, but mistakes are the sole reponsibility of the 
author...". Does anyone really believe that? See the two people on 
this page? If you find tcchnicaJ problems, it's probably ^A^faulL : ) 






Jess works at Hewlett-Packard on the Self- 
Healing Services Team. She has a Bachelor s 
in Computer Engineering from Villanova 
University, has her SCPJ 1.4 and SCWCD 
certificadons» and is literally months away 
from receiving her Masters in Software 
Engineering at Drexel University (whew!) 

WTien she's not working, studying or 
motoring in her MINI Cooper S, Jess can 
be found fighting her cat for yam as she 
completes her latest knitting or crochet 
project (anybody want a hat?) She is 
originally from Salt Lake City, Utah (no, 
she s not Mormon... yes, you were loo 
going to ask) and is cunrendy living near 
Philadelphia with her husband, Mendra, and 
two cats: Chai and Sake. 

You can catch her moderating technical 
forums acjavaranch.com. 



Valentm Valenijn Crettaz has a Masters degree 
in Inforraauon and Computer Science from 
the Swiss Federal Institute of Technology in 
Lausanne (EPFL). He has worked as a software 
engineer with SRI International (Menlo Park, 
GA) and as a principal engineer in the Sofnvare 
Engineering Laboratory of EPEL. 

Valentin is the co-founder and CTO of Condris 
Technologies, a company specializing in the 
development of software architecture soludons. 

His research and development interests 
include aspect-oriented technologies, design 
and architectural patterns, web services^ and 
software architecture. Besides taking care of 
his \Wfe, gardening, reading, and doing some 
sport, Valentin moderates the SCBCD and 
SCDJWS forums atjavaranch.com. He holds 
the SCJP, SCJD, SCBCD, SCWCD, and SCDJWS 
certifications. He has also had the oppommicy 
to serve as a co-author for Whizlabs SCBCD 
Exam SimuJator 

(We're stiil in shock from seeing him in a ti£.) 
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Other people to bl^e; 

Ai O'Reilly: 

Our biggest thanks to Mike Loulddes at O'Reilly, for taking a 
chance on this, and helping to shape the Head First concept into 
a tK>ok (and serks) . As this second edition goes to print there 
are now five Head First books» and he's been with us all the way. 
To Tim O^ReiUy, for his willingness to launch into something 
camplei^ly new and dilFerent. Thanks to tl^ie clever Kyle Hart for 
figuring out how Head First fits into the world, and for launching 

series. Finally, to Edie Freedman for designing the Head First 
•«^mphasize the hea/f coven 

0ur intrepid beta testers and reviewer team: 

^Otir top honors and thanks go to the director of ourjavaranch 
ji:fe^h review team, Johannes de Jong, This is your fifth time arouad 
Smth us on a Head First book, and weVe thrilled you're still speaking 
to us. Jeff Cumps is on his third book with us now and relentless 
about finding areas where we needed to be more clear or correct. 

L Corey McGIone, you rock. And we think you give the clearest 
I explanations on javaranch. You'll probably notice we stole one or 
mt^o of them. Jason Menard saved our technical butts on more 
than a few details, and Thomas Paul, as always, gave us expert 
feedback and found the subtle Java issues the rest of us missed. 
Jane Griscti has her Java chops (and knows a thing or two about 
wrUing) and it was great to have her helping on the new edition 
along with long-time javarancher Barry Gaunt 

Marilyn de Queiroz gave us excellent help on both editions of the 
book. Chriis Jones, John Nyquist^ James Cubeta, Terri Cubeta, 
d Ira Becker gave us a ton of help on the first edition. 

■ecial Uianks to a few of the Head Firsters whoVe been helping 
us from the beginning: Angelo Celeste, Mikalai Zaildn^ and 
Thomas Duff (twduffxom). And thanks to our terrific agent, Davnd 
geiberg of StudioB (but seriously^ what about the movie rights^) 
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still more acknowledgements 

Just when you thought there wouldn't be any 
more acknowledgements^ 

Mare Java technical experts who helped out on the first edition (in pseudomndom order): 

Emiko Hori, Michael Taupitz, Mike Gallihugh, Manish Hatwalne, James Chegwidden, 
Shweta Mathur, Mohamed Mazahim, John Paverd, Joseph Bih, Skulrat Patanavanich, 
Sunil Palicha, Suddhasatwa Ghosh, Ramki Srinivasan, Alfred Raouf, Angelo Celeste, 
Mikalai Zaikin, John Zoetebier,Jim Pleger, Barry Gaunt, and Mark Dielen. 

The first edition puzzle team: 

Dirk Schreckmann, Mary "JavaCross Champion" Leners, Rodney J. Woodrufi", Gavin Bong, 
and Jason Menard. Javaranch is lucky to have you all helping out. 

Other co~conspirat&rs to thank: 

Paul Wheaton, the javaranch Trail Boss for supporting thousands of Java learners. 
Solveig Haugland, mistress of J2EE and author of "Dating Design Patterns". 
Authors Dori Smith and Tom Negrino (backupbrain.com), for helping us navigate the 
tech book world. 

Our Head First partners in crime, Eric Freeman and Beth Freeman (authors of Head First 
Design Patterns), for giving us the Bawls"^^ to finish this on time. 
Sherry Dorris, for the things that really matter. 

Brave Early Adopts ofihe Head First series: 

Joe Litton, Ross R Goldberg, Dominic Da Silva, honestpuck, Danny Bromberg, Stephen 
Lepp, Elton Hughes, Eric Christensen, Vulinh Nguyen, Mark Rau, Abdulhaf, Nathan 
Oliphant, Michael Bradly, Alex Darrow, Michael Fischer, Sarah Nottingham, Tim Allen, 
Bob Thomas, and Mike Bibby (the first). 



*The large number of acknowledgements is because we're testing the theory that everyone mentioned in 
a book acknowledgement will buy at least one copy, probably more, what with relatives and everything. If 
you'd like to be in the acknowledgement of our next book, and you have a large family, write to us. 
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Breaking the Surface 





Java takes you to new places. From its humble release to the public as the 
(wimpy) version 1 .02 Java seduced p^ogramnners with Its friendly syntax, object-oriented features, 
memory management, and best of all— the promise of portability. The lure of write-once/run- 
anywhere is just too strong. A devoted following exploded, as programmers fought against bugs, 
limitations, and, oh yeah, the fact that it was dog slow. But that was ages ago. If you're just starting in 
Java, youYe tucky. Some of us had to walk five miles in the snow, uphill both ways (barefoot), to 
get even the most trivial applet to work. Butyoa, why, yot; get to ride the sleeker, faster, much 
more powerful Java of today. 
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The Way Java Works 

The goal Is to write one application (in this 
example, an interactive party invitation) and have 
It work on whatever device your friends have. 



source code for 
the Interactive 
party invitation. 




Create a source 
document. Use an 
established protocol 
(In this case, the Java 
language). 



Run your document 
through a source code 
compiler.The compiler 
checks for errors and 
won't let you compile 
until It's satisfied that 
everything will run 
correctly. 



The compiler creates a 
new document coded 
into Java byfecode. 
Any device capable of 
running Java will be able 
to Interpret/translate 
this file into something 
it can run.The compiled 
bytecode is platform- 
independent. 



virtual 
Maehlnes 



O 



Your friends don't have 
a physical Java Machine, 
but they all have a 
Wrfi/fl/Java machine 
(implemented in 
software) running inside 
their electronic gadgets. 
The virtual machine reads 
and runs the bytecode. 



2 chapter 1 
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hatyoulldoih Java 

You'll type a source code file, compile it using the 
Javac compiler, then run the compiled bytecode 
on a Java virtual machine. 



java.awt"; 
iava.awtevenL'; 
Party{ 
p(i>fcvoid bjilcJlnvneO{ 

Frame f=oewFrBm60: 
Label I = new LabelfParty at Tim's"); 
Sutton b = new euttortCYou beO: 
Button c = new Button(*Shool me"); 
Panel p = new PanelQ; 

) # more code hefs.., 



I Efl^t WTflctow Help Pteaa 



i javac Party . java 



Source 



Type your source code. 
Save as; Party-java 



Compiler 

o 



P Compile the Portyjflwi 

fife by running javac 
(the compiler application). 
If you don't have errors, 
you'll get a second docu- 
ment named Party.dass 

The compiler-generated 
Party,clas5 file is made up 
ofbytecodei. 



Method ParlyO 

0 aload_0 

1 lnvDkespedal#1 <Mathod 
)ava.lan9.0bjedO> 

4 return 

Method void buftdlnviteO 

0 new #2 <Cla3s ]ava^wLFrame> 

3dup 

4 invokespedal if^ <Mettiod 
)8va,awlFram60> 



I Fite BdH Window Help Swwar 



Output 
(ftode) 

O 

Complied code: Party.dass 



;java Party 



A&A . _ 

Party at Tim's? 



Virtual 
MaehlHes 



O 



Run the program by 
starting the Java Virtual 
Machine (JVMJ with the 
Party,dass file. The JVM 
translates the bytecode 
into something the 
underlying platform 
understands, and runs 
your program. 



v^an-t yow to d (tt\ (<»r how \i all frti iii^tiKcv.) 
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A very brief history of Java 
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Java 1.02 



250 classes 
Slow. 

Cute name and logo. 
Fun to use. Lots of 
bugs. App/efs are 
the Big Thing. 



Java 1,1 

500 classes 

A //ftfe faster. 

More capable, friendlier. 
Becoming very popular. 
Better GUI code. 



> 



-2 



Java 2 
(wrsloHs 12 - 14) 

2300 classes 

Much faster. 

Can (sometimes) run at 
native speeds. Serious, 
poKfer/u/. Comes in three 
flavors: Micro Edition (J2ME), 
Standard Edition (J2SE) and 
Enterprise Edition tJ2EE). 
Becomes the language of 
choice for new enterprise 
(especially web-based) and 
mobile applications. 



Java 5.0 
(versions 1.5 and op) 

3500 classes 

More power, easier to 
develop with. 

Besides adding more than a 
thousand additional classes, 
Java 5.0 (known asTiger^ 
added major changes to 
the language itself, making 
it easier (at least in theory) 
for programmers and giving 
rt new features that were 
popular in other languages. 



a 

CO 
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look how easy it 
ts to write Java. 



i^^pen your pencil 



Try to guess what each line of code Is doing„ 
(answers are on the next page). 



int size = 27? 
String nasnB = "Fide"; 

ntyDog = new Dog (name, size); 
w size - 5; 
(X < 15) myDog,bar)c(8 ) ; 

nilfe (X > 3) { 
i^rDog -playO ; 



t(] numList - {2,4, 6,8} ; 
u out, print ("'Hello") ? 
R^out.printC'Dogi " + name); 
itiq num = "8"; 
z = Integer. parselnt(num) ; 



{ 

teadTheFile('%yPile.txt'* ) ; 

5h(FileNotFoundException ex) { 
System, out. print( "File not found,"); 



I tee Java 2 and Java 5.0, but was there a Java 3 
> And why h It Java 5.0 but not Java 2.07 



The joys of marketing,., when the version of Java 
I from 1.1 to 1.2, the changes to Java were so 
'B-natic that the marketers decided we needed a whole 
'nameTsothey started calling \tJava2, even though 

jai version of Java was 1.2. But versions 1.3 and 1.4 
I still considered Java2. There never wos a Java 3 or 
^l^egtnnfng with Java version 1 .5, the marketers decided 




once again that the changes were so dramatic that a 
new name was needed (and most developers agreed), so 
they looked at the options. The next number In the name 
sequence would be "3" but calling Java KSJavo 3 seemed 
more confusing, so they decided to name It Java 5.0 to 
match thews'' in version "1.5^ 

So, the original Java was versions 1.02 (the first official 
release) through 1.1 were just "Java" Versions 1.2, 1.3, and 
1.4 were "Java 21 And beginning with version l.SJava is 
called ''Java S.OIBut you'll also see it called "Java 5" (without 
the^'.O'O and "Tiger" (its original code-name). We have no 
idea what will happen with the next release,.. 
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why Java is cool 



sn your pencil ansWGfS 



look how easy it 
Is to write Java- 



Don*t worry about whether you understand any of this yetf 

Everything here Is explained in great detail In the book, most 
within the first 40 pages). If Java resembles a language youVe 
used in the past, some of this will be simple. If not, dont v/ony 
about it. Well get there... 



int size - 27; 

String name = ^Fido"; 

Dog inyDog - new Dog (name, size); 

X = size - 5? 

if (X < 15) myDog.bark(8) ; 

while {X > 3) { 
royDog-play( ) ; 

} 

int[] numList = {2,4,6,8}; 
System . out . print ( "Hello" ) ; 
System. out. printC'Dogi " + name); 
String num - "'8"; 
At 2 = Integer . par selnt( num) ; 



it (vj)w tyf 12) U l«i tUh 15, 0^ dc<^ is. e t«i 




kiW tKe <^ to ?laY (wKajgvcr THAT b> a 



tKii l«ob like ^ end ^ tKe !«* ^ cv- 



{ ] a (W Ph -IK* lo 




dedbrt a I'^t of ^sigyti vjrijblg 'nuwliii', and pwt iftio Ox li^ 



Yr^i <^ "Mlo fide" (iKc value Ji 'r^^' \i W) at {K< ^p^nd-lit^ 



dfcdavt a iKa**a£t£»r sfaSi^ variable 'num* and jive \i vjW of V 
io^vert i)< sfa-ihj of t^uirri V ml^ an a^t-al nuw^^t^t value 6 



try { 

readTheFi le ( ^myPile . txt" ) ; 

> 

catch (FileMotJPoundException ex) { 

Sys tern. out. print (*File not found,"); 

> 



hrj {fi do lowrDiihj ■ i^aybe tKe tKinj weW tryih^ isn^t juavanteed t> iw^^ 



rtid a trxi file nap^ \f \\t^U* U ai Ica^t TKV U ^-ead tKe fileJ 



W tVie end o^ t)>€ "tKlny try**, | yo*i dould fcry »vjry il>kny^- 



tKi^ wsurt be %iKere you ^ind tfjj hf tKe tli'mj yw* favd did/t ^^crk... 

^ tKe tKinJ we trkd failed, print "File not found*" «<*t at tK< d^J-nn^and-Itne 
locb like ev^rytKinj in tKe { ] iJ Aat d^ if^ tKe 'fa-/^ d»d«'t .- 
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structure iy\ Java 



a class in a source file, 
methods in a class, 
statements in a method. 



What goes in a 

source file? 

A source code file (with the Java 
extension) holds one cZa« defini- 
tion. The class represents a piece 
of your program, although a very 
tiny application might need just 
a single class. The class must go 
within a pair of curly braces. 



What goes in a 

class? 

A class has one or more methods. 
In tiie Dog class, the bark method 
will hold instructions for how the 
Dog should bark. Your methods 
must be declared imidez class 
(in other words, within the curly 
braces of the class). 



public class Dcg { 



class 



public class Dog ( 
void barkO { 




Whaf goes In a 

method? 

Within the curly braces of a 
metliod, write your instructions 
for how thai method should be 
performed. Method code '\s basi- 
cally a set of statements, and for 
now you can think of a method 
kind of like a function or proce- 
dure. 



public class Dog { 
void bark{) { 
atatranentl; 
stateinent2 ; 

) 

statemewts 
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a Java class 

Anatomy of a class 

When the JVM starts running, it looks for the class you give it at the com- 
mand line. Then it starts looking for a specially-writien method that looks 
exacdy like: 

public static void main (String () args) ( 
// your code goes here 

) 

Next, the JVM runs everything between the curly braces { } of your main 
method. Every Java application has to have at least one class^ and at least 
one main method (not one main per class; just one main per applkation). 



tan at^ 




void th<3ns tKcrc s 

\ 



■(Jie name tX 
•this wctiiod 



Tk» -vetKod f^uti be jive^ 

array o( String., a,^ the 
airray will be tailed 'ary' 



nrongiEnTnaiiigBniffCTi 



jB^tem, out . prii^ 



(defaults to tOfrvmdrid-W) 



^tlosinj b*-ate o( the MyPi^tAff eia« 



Don'-t worv-y about memoi'izin^ arything right >%o^«... 
thii thaftev is just h> get you started- 
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Writing a class with a main 



In Java, everything goes in a class. You*ll type your source code file (with a 
.Java extension), then compile it into a new class file (with a .class Gxtension). 
When you run your program, you*re really running a class. 

Running a program means telling the Java Virtual Machine (JVM) to "Load the 
Hello class, then start executing its main ( ) method- Keep running 'tj] all the 
code in main is finished." 

In chapter 2, we go deeper into the whole class thing, but for now, all you need to 
think is, hmu do IwrUeJcwa code so that it zinU nmf And it all begins with maiii(). 

The main() method is where your program starts running. 

No matter how big your program is (in other words, no matter how many classes 
your program uses), there's got to be a mainO method to get the ball rolling. 



public class MyFirat^ ( 



OSave 




public static void main {StriDg[] args) ( 
Systoft.out.priXktlnC'r Ihile!^); 
Systam.out.printlnt'Tba Kdrld") ; 



MyFiratJ^p . java 



Q Compile 



javac MyFirfltJ^p. java 



ORud 



i Re £drt Window Help Scream 
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statements^ looping, branching 

What caH you say Ih the main method? 

Once youVe inside main (or an> method), the fun 
begins. You can say all the normal things that you say 
in most programming languages to make ihe campider 
do something. 

Your code can tell the JVM to: 



Q dosomethihg 




Sutements: declarations, assignments, 
method calls, etc. 

int K = 3; 

String name = "^Dirk"; 
X - X * 17; 

System . out .print (^^x is " + x) ; 
double d = Math . random () ; 
// this is a comment 



Q do something agalh a»id 

\joop^:forar\d while 

wbile (X > 12) { 
X = >c -1; 

) 



for (int X = 0; X < 10; x = x + 1) { 
System.out .print C'x is now + x) ; 

} 



Q do something uhder this eohdttioM 

Branching: ff/efse tests 



if (X == 10) I 

System. out. print{"x must be 10"); 
} else { 

System. out. printC^x isn't 10"); 

) 

if ((X < 3) i (name. equals ("Dirk") ) ) ( 
Sys tern. out .println (""Gently") ; 

) 

System. out .print ("this line runs no matter what"); 




Syntax 



Each statement must end in a 
semicolon. 

X = X + 1 ; 

♦ A single-line comment begins 
with two forward slashes. 

X = 22; 

// thia line disturhfi me 

Most white space doesn't matter. 
X = 3 ; 

*■ Variables are declared with a 
name and a type (you'll learn about 
all the Java types in chapter 3). 

int weight; 

/ / type: int , name: weight 

* Classes and methods must be 
defined within a pair of curly braces. 

public void go () { 

// amazing code here 

} 
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while (morcSalls =- true) { 
keepJugg/ing{); 



Looping and looping and... 



Java has three standard looping constracts: whiU, 
do<vhile, and for. You'll get the full loop scoop later 
in the book> but not for awhile, so let*s do whiUiox 
now. 

The syntax (not to mention logic) is so simple 
you're probably asleep already. As long as some 
condition is true, you do everything inside the 
loop bhck. The loop block is bounded by a pair of 
curly braces^ so whatever you want to repeat needs 
to be inside that block. 

The key to a loop is the conditional UsL In Java, a 
condiuonal test is an expression that results in a 
boolean value — in other words, something that is 
either true ox false. 

If you say somed^ing like, "While iceCreamlnTheTub 
is true, keep scooping", you have a clear boolean 
test. There either is ice cream in the tub or there 
isnL But if you were to say, ''While Bob keep 
scooping", you don't have a real lesL To make 
that work, you'd have to change it to something 
like, "While Bob is snoring...'' or *'While Bob is not 
wearing plaid,.." 



Simple boolean tests 

You can do a simple boolean test by checking 
the value of a variable, using a comparison operator 
including: 

< (less than) 
> (greater than) 

= (cqtiality) (yes, that's two equals signs) 

Notice the difference between the assignment 
operator (a single equs^s sign) and the equals 
operator (two equals signs). Lots of programmers 
accidentally type « when they want (But not 
you.) 

int X =^ 4; // assign 4 to x 

while (X > 3) { 

// loop code will run because 

// X is greater than 3 

X = X - 1; //or we'd loop forever 

} 

int z = 27; // 
while (z 17) { 

// loop code will not run because 

// 2 is not equal to 17 

1 
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Java basics 



Why daes everything have 
to be in a flasi? 



A: 



Java IS an object-oriented 
(00) language. It's not like the 
old days when you had steam- 
driven connpllers and wrote one 
monolithic sourceflle with a pile 
of procedures. In chapter 2 you'll 
learn that a class is a blueprint for 
an object, and that nearly every- 
thing in Java is an object. 

Do I have to put a main In 
every class I wrHe? 



A: 



Nope. A Java program 
might use dozens of classes (even 
hundreds), but you might only 
have one with a main method — 
the one that starts the program 
running. You might write test 
classes^ though, that have main 
methods for testing your other 
classes. 

0/ In my other language I can 
do a boolean test on an Integer, 
In Java, can I say something like: 

Int X = 1; 

while (x){ } 



A: 



No, A boolean and an 
integer are not compatible types in 
Java. Since the result of a condi- 
tional test must be a boolean, the 
only variable you can directly test 
(without using a comparison op- 
erator) is a booiean. For example, 
you can say; 

boolean is Hot * true; 
while (isHot) { ) 



Example of a while loop 

public class Loopy { 

public static void main (String[] args) { 
int X = 1; 

System-OUt .println ("Before the Loop"); 
while (X < 4) { 

System, out. printlnPIn the loop''); 

System. out. println{'^Value of x is " + x) ; 
X = X + 1; 

) 

System, out. printlnC'This is after the loop"); 



} 



% java Loopy 
Bo£or« tha Loop 
In tho loop 
Valu« of X iB 1 
lEL tha loop 
Value of X Ifl 2 
In thtt loop 
Valutt of X ia 3 
This l8 aftar tha loop 



BULUT POINTS 




Statements end in a semicolon ; 

Code blocks are defined by a pair of curly braces { } 

Declare an ini variable wfth a name and a type: irrt x; 

The assignment operator Is one equals sign = 

The equals operator uses two equals signs == 

A while loop mns everything within its block {defined by curly 
braces) as long as the corxiitionai test is frue. 

if the conditional test is false, the while loop code block wont 
run, and execution will move down to the code immediately 
after the loop block. 

Put a boolean test inside parentheses: 
while (X = 4) ( } 
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PPJava, an if test is basically the same as the boolean test in a 
sJkii^Ioop - except instead of saying, '"while there*s still beer...**, 
i1l say, "t/there*s still beer..." 

5s IfTest { 

IjPUblic static void main (String [] args) { 
int X = 3; 
if (X == 3) ( 

System. out. println ("X must be 3"); 

} 

System.out .println (''This runs no matter what"); 
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SYSteiH.out.priHt v». 
SyitBiR.oirt.iH'Iirtlll 

If you've been paying attentfon (of 
course yoii have) then you've notfced| 
switching between prEnt and prtildn 

fHd you spot th# dftferancs? 

Syiteim^ut^Jfit/n inserts d newlfne 
(think of print/fi as prf ntif twf Im while 
tout|9Wnr keeps pHntfngI 




I Java IfTaat . 
ouat be 3 

ta runa no matter what 



nrhe code above executes the line that prints "x must be 3" only 
l^tbe condition (:tis equal to 3) is true. Regardless of whether 
L true, though, the line that prints, "This runs no matter what" 
run. So depending on the value of x, either one statement 
[or two will print out 

It we can add an eke to the condition, so that we can 
p something like, "J/ there's still beer, keep coding, else 
lerwise) get more beer, and then continue on..." 

tass IfTest2 { 

public static void main (String () args) ( 
int X - 2; 
if (X 3) { 

System. out .println C'x must be 3"); 
} else { 

System. out .println C'x is NOT 3"); 

) 

System. out .println ("'This runs no matter what") ; 

) 



% java I£Te8t2 
. X ia MOT 3 
ifhifl runs no matter i^t 



— 4|^^pen your pencil 



GIvtn the output: 

% java DooBee 
DooBeeDooBeaI>o 



Fllf In the missing code: 

public class DooBee { 
public static void main (StringQ args) { 
intx = 1; 

while (x < ) ( 

System.out. ("Doo'O; 

System.out. ("See'O; 

x = x+ 1; 
} 

\ii^== )( 



Syste m.o ut.pri ntC'Do''); 



) 
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serious Java app 



Coding a Serious business 
Appllcatlovi 

Let*s put all your new Java skills to good me with 
something practical. We need a class with a main(), an int 
and a 5^ri-ng variable, a whikloop, and an i/test A little 
more polish^ and you'll be building that business back- 
end in no time. But before you look at the code on this 
page, think for a moment about how ^ou would code that 
classic children's favorite, **99 bottles of been" 



public class BeerSong { 

public static void main (String!] args) { 
int beerNum = 95; 
String word = "^bottles"; 

while (beerNum > 0) { 

if (beerNum ==1) { 

word ^'bottle"; // singular, as in ONE bottle. 

) 

System, out »println (beerNum + " + word + " of beer on the wall") ; 
System. out. println (beerNuin + " " + word + of beer."); 
System, out -println ("'Take one down."); 
System, out .println (""Pass it around,"); 
beerNum - beerNum - 1; 

if (beerNum > 0) { 

System. out ,println (beerNum ^• " + word + of beer on the wall"); 
} else ( 

System. out. println (''No more bottles of beer on the wall") ; 
} // end else 
} 11 end while loop 
} // end main method 
} // end class 




There's Jtlll one little flaw In our 
code. It complies and runs, but the 
output Isn't 1 00% perfect See If 
you can spot the flaw . and fix It. 
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Hi^onday mornliig at ?ob's 

Bob*s alarm clock rings at 8:30 Monday morning, just like every other weekday 
But Bob had a wild weekend, and reaches for the SNOOZE button. 
.Ajnd that's when the action starts, and the Java-enabled appliances 
come to life, 

Firsi^ the alarm dock sends a message to the coffee maker^ "Hey the geek's 
keeping in again, delay the coffee 12 minutes." 

The coffee maker sends a message to the Motorola'^ 
^ toaster, '*Hold the toast, Bob's snoozing." 

The alarm clock then sends a message to Bob*s 
Nokia Navigator™ cell phone, *'Call Bob's 9 
o'clock and te^ him weVe running a little late/* 

Fmaljy, die alarm clock sends a message to 
Sam's (Sam is the dog) wireless collar, with the too-familiar signal that 
means, "Get the paper, but don't expect a walk." 

A few minutes later, the alarm goes off again. And a^ain Bob 
hits SNOOZE and the appliances stan chattenng Finally, 
the alarm rings a third dme. But just as Bob reaches for the 
snooze button, the dock sends the ''j^mp and bark" signal to Sam's 
collar. Shocked to full consciousness, Bob rises, grateful that hs$Jmm 
skills and a little trip to Radio Sback"^ have enhanced the daily 
routines of his life. 

His toast is toasted. 




Java Kcre h>o 




Java 



His coffee steams. 



His paper awaits. 

Just another wonderful morning in TTte Java^Enabled House. 

You can have a Java-enabled home. Stick with a sensible soluaon using Java, 
Eiiiemet, and Jini technology. Beware of imitations using other so-called '^lug 
and play" (which actually means "plug and play \viih it for the next three days 
trying to get it to work") or '"portable" platforms. Bob's sister Berry cried one of 
diose others, and the results were, welij not very appealing, or safe. 
Bit of a shame about her dog, too... 



Could this story be true? Yes and no. While there are versions of Java running in de- 
vices including PDAs, cell phones (especially ceW phones), pagers, rings, smart cards, 
and more -you might not find a Java toaster or dog collar. But even if you can't 
find a Java-enabled version of your favorite gadget, you can still run it as if it iv^re a 
Java device by controlling it through some other Interface (say, your laptop) that is 
running Java,Thls Is known as the Jini surrogate architecture. you con have that 
geek dream home. 




*}PmuttIcost If you're gonna be all picky about protocol 
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let's write a program 





OK, so the beer song wasn't really a serious 
business application. Still need something 
practical to show the boss? Check out the 
Phrase-O-Matic code. 



public class FhraseOlatic { 

public static void main (StringH args) { 

// malt* thr»* t*H of wodi to (hooM frotiu Ud yo^r 

string [] wordListOne = {"24/7"/'nniLti- 
TiAT'^ , "30 , 000 foot" , "B-to-B" , "win-win" , "front- 
end", ^^wab-based'',''pervasivtt", smart", ^^aix- 
sigma", "critical -path", ''dynamic"}; 



String [] wordLietTwo = { "eanpowered", ''sticJcy", 
>alua-addAd" , "oriented", "centric", ^^distributed" , 
^'clustered", "branded" /'outsida-the-box", 'positioned", 
"networlced", "focused", leveraged" , ''aligned", 
"targeted", "shared", "cooperative", '^accelerated"); 

String tl wordListThree = ("process", "tipping- 
point", "solution", "architecture", "core competency", 
"strategy", ^^ndshare", "portal", "space", "vision", 
"paradigm", "mission"} ; 



o 



// find out bow many words are In oaik Bst 

int oneLength = wordListOne, length; 
int twoLength = wordLiatTwo. length; 
int threeLength = wordListThree. length; 

// gonorate tWoe random numbers 

int randl » (int) (Math . random () * oneLength); 
int rand2 = (int) (Math. random () * twoLength) ; 
int rand3 = (int) (Math. random () * threeLength) 



// now build a pbroso 

string phrase = wordListOne [randl] + " " + 
wordListTwo[rand2] + " " + wordListThree [rand3] ; 

// print out the pbraso 

Sys^tem, out. println( "What we need is a " + phrase) 

} 
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rase-O-Matlc 

ta nutshellj the program makes three lists of words, then randomly picks one word 
each of the three lists; and prints out the result- Don*t worry if you don't under- 
; «awr/^y what's happening in each line. For gosh sakes, you Ve got the whole book 
she^d of you, so relax. This is just a quick look from a 30,000 foot outside-the-box 
^rgeted leveraged paradigm. 

The first step is to create three String arrays - the containers that will hold all the 
Declaring and creating an array is easy; here's a small one: 

j[] pats » r'Fido", ^Zaua", ^'Bln'^}; 

TEidi W6rd is in quotes (as all good Strings must be) and separated by commas. 



For each of the three lists (arrays), the go2d is to pick a random word, so we have 
» know how many words are in each list If there are 14 words in a list, then we need 
Liandom nimaber between 0 and 13 (Java arrays are zero-based, so the first word is at 
poadon 0, the second word position 1, and the last word is position 13 in a I4-element 
y). Quite handily, a Java array is more than happy to tell you its length. You just 
r fi>'ask In the pets array, we*d say: 

= pets, length; 

I X would now hold the value 3. 



what wo need 
here Ib a... 



pervasive targeted 
process 



3* need three random numbers. Java ships out-of-the-box, off-the-shelf, shrink- 
wrapped, and core competent with a set of math methods (for now, think of them as 
femctions). The random ( ) method returns a random number between 0 and not- 
Bie-1, so we have to multiply it by the number of elements (the zurray length) in the 
I we're using. We have to force the result to be an integer (no decimals allowed!) so 
I put in a cast (you'll get the details in chapter 4) . It*s the same as if we had any float- 
5 point number that we wanted to convert to an integer 

iat X » (int) 24.6; 

Now we get to bmld the phrase, by picking a word from each of the three lists, 
jud smooshing them together (also inserting spaces between words). We use the 
ofierator, which concatenates (we prefer the more technical 'svtooshes') the String objects 
Vgether To get an element firom an array, you give the array the index number (posi- 
i) of the thing you want using: 

Striog s = petstO]; // s i« now thm String ^rido" 

s + " " + "ia a dog^; // s ia now "Fido la m dog" 



dynamic outside- 
the-box tipping- 
point 



smart distributed 
core competency 



24/7 empowered 
mindshare 



30,000 fool win-win 
vision 



slx*sigma net- 
worked portal 



sFmally, we print the phrase to the comjnand-Iine and... voila! We^rein 
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the compiler and the JVM 



Fireside Chats 




Tonight's Talk: The compiler and 
the JVH battle over the qriestion, 
"Who's more important?'' 



The Java Virtual Machine 

What, are you kidding? HELLO. I aw Java, 
rm the guy who actually makes a program 
ruTL The compDer just gives you a^ZfL That's 
it. Just a file. You can print it out and use it 
for wall paper, kindling, lining the bird cage 
what^^, but the file doesn't ^anything un- 
less T*m there to run it 

And that's another thing, the compiler has 
no sense of humor. Then again, if ;yauhad to 
spend aJJ day checking nit-picky little syntax 
violations... 



Vva not saying you're, Hke, compUtely useless. 
But really, what is it that you do? Seriously, I 
have no idea. A programmer could just write 
bytecode by hand, and Vd take it You might 
be out of a job soon, buddy. 



(I rest my case on the humor thing.) But you 
still didn*t answer my question, what dioyou 
actually do? 



The Compiler 



I don't appreciate that tone. 



Excuse me, but without me, what exactiy 
would you run? There's a reasonj^vz was 
designed to use a bytecode compiler, for your 
information. If Java were a purely interpreted 
language, where— at runtime — the virtual 
machine had to translate straight-from-a-text- 
editor source code, a Java program would 
run at a ludicrously glacial pace. Java's had a 
challenging enough time convincing people 
that it*s finally fast and powerful enough for 
mostjobs. 



Excuse me, but that's quite an ignorant (not 
to mention arrogant) perspective. While it 
is true xh2it—tk€oreticaUy — you can run any 
properly formatted bytecode even if it didn't 
come out of a Java compiler, in practice that's 
absurd. A programmer writing bytecode by 
hand is Uke doing your word processing by 
writing raw postscript. And I would appreciate 
it if you would not refer to me as "buddy." 
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The Java Virtual Madiine 



But some still get through! I can throw Class- 
CastExceptions and sometimes I get people 
trying to put the wrong type of thing in an 
array that was declared to hold something 
else, and — 



OK Sure. But what about security} Look at all 
the security stuff I do, and you're like, what, 
checking for semicolons? Oooohhh big security 
riski Thank goodness for you! 



Whatever. I have to do that same stuJBF too, 
though, just to make sure nobody snuck in 
after you and changed the bytecode before 
running it. 



Oh, you can count on it. Buddy, 



The Compiler 

Remember that Java is a strongly-typed lan- 
guage, and that means I can't allow variables 
to hold data of the wrong type. This is a 
crucial safety feature, and Fm able to stop the 
vast majority of violations before they ever get 
to you. And I also — 



Excuse me, but I wasn't done. And yes, there 
are some datatype exceptions that can emerge 
at runtime, but some of those have to be 
allowed to support one of Java's other impor- 
tant features — dynamic binding. At runtime, 
a Java program can include new objects that 
weren't even known to the original program- 
mer, so I have to allow a certain amount of 
flexibility. But my job is to stop anything that 
would never — could never — succeed at run- 
time. Usually I can tell when something won't 
work, for example, if a programmer acciden- 
tally tried to use a Button object as a Socket 
connection, I would detect that and thus 
protect him from causing harm at runtime. 



Excuse me, but I am the first line of defense, 
as they say. The datatype violations I previous- 
ly described could wreak havoc in a program 
if they were allowed to manifest. I am also 
the one who prevents access violations, such 
as code trying to invoke a private method, or 
change a method that - for security reasons 
- must never be changed. I stop people from 
touching code they're not meant to see, 
including code trying to access another class' 
critical data. It would take hours, perhaps days 
even, to describe the significance of my work. 



Of course, but as I indicated previously, if I 
didn't prevent what amounts to perhaps 99% 
of the potential problems, you would grind to 
a halt And it looks like we're out of time, so 
we'll have to revisit this in a later chat. 
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exercise: Code Magnets 



E^se Cocte Magnets 




A working Java program is all scrambled up 
on the fridge. Can you rearrange the code 
snippets to make a worklrig Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up. so feel 
free to add as many of those as you need! 



^BUOTex:^ 




if {X == 2) { 

System.out. print ( cy^ 

} 





dive In A Quick Dip 



EacK of i^e Java (lies on ttos page 
represents a coBiplete source file. 
Your job is to play coij^ler an4 
deterniiQe ^edier eacK of ^se 

files will compile. IfAey 
won't cop^e, how 
would you fix 




B 

public static void main(String [] args) { 
int X = 5; 
while ( X > 1 ) { 
X = X - 1; 
if ( X O) { 
System.out.printlnCsmall x"); 

} 

) 

) 



&s Exerciselb { 
imbiic static void main(String [) args) { 
int X = 1; 
while ( X < 10 ) { 
if ( X > 3) { 
SyBtam.out.printlnCbig x"); 

} 

} 

} 



class Exerciselb { 
int x - 5j 
vhile ( X > 1 ) { 
X = X - I; 
if ( X < 3) ( 

System»out»priivtln(^small x**); 

} 

) 

} 
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puzzle: crossword 



Lefs gfve your right brain something to do. 

If s your standard crossword but almost all 
of the solution words are from chapfter 1 Just 
to keep you awake, we also threw in a few 
(non-Java) words from the high-tech world. 



Across 

4. Command-line invoker 
6. Back again? 

8. Can't go both ways 

9. Acronym for your laptop's power 

12. number variable type 

13. Acronym for a chip 

1 4. Say something 

1 8. Quite a crew of characters 

1 9. Announce a new class or method 
2 1 . Whaf s a prompt good for? 









1 




2 






3 


4 


5 








6 




















7 
















a 




1 












9 


10 




11 












12 










































13 






14 










16 






































^ 
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Down 

1. Not an integer (or _ 



.your boat) 



2. Come back empty-handed 

3. Open house 

5. Things' holders 

7. Until attitudes improve 

10. Source code consumer 

11. Can't pin it down 
13. Dept. of LAN Jockeys 

15. Shocking modifier 

16. Just gotta have one 

1 7. How to get things done 
20. Bytecode consumer 
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dive In A Quick Dip 



A short Java program Is listed below. One block of the program 
is missing. Your challenge is to match the candidate block of 
code (on the left), with the output that you'd see If the block 
were inserted. Not all the lines of output will be used, and some 
of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. (The answers are at the end of the chapter). 



class Test ( 

public static void main (String [] args) { 
int X = 0; 
int y = 0; 
while ( X < 5 ) { 



System.out .print (x + + y ; 
X = X + L; 



Candidates: 



Possible output: 
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puzzle: Pool Puzzle 




Your Job is to take code snippets from the 
pool and piace them into the blank 
lines in the code. You may not use the 
same snippet more than once, and 
you won't need to use all the snip- 
pets. Your goo/ is to make a class that 
will compile and run and produce the 
output listed. Don't be fooled— this one's 
harder than it looks. 



Output 



I nia Edit windcw Help Cheai 



%java PoolPuzzleOne 



a noise 



annoys 



an oyster 



class PoolP\i22leOne { 

public static void main (String [1 args) { 
int X = 0; 



Note: Each snippet 
from the pool can be 
used only oncel 



m 



x>0 
x< 1 
x> 1 
x> 3 
X < 4 



while ( 



) { 



System.out.printr 
System.out.printra"); 
System.out.printrn 
System.out.prlntCan"); 



X = x+ 1; 
X = x + 2; 
X = X - 2; 
X = X - 1 ; 



if ( X < 1 ) { 



if ( 



) { 



if ( X == 1 ) { 



} 

if ( 



) { 



> 

System, out , print In 




System.oat.printCnoys 
System.out.printCoise'O; 
System.out.prjnt(" oyster 
System.out.printCannoys"); 
System.out.print("noise''); 
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Magnets: 

ghufflel { 

Ic static void main (String [] args) { 

at X 3 ; 
lutille (X > 0) { 



dive In A Quick Dip 

class Exerciselb { 
public static void main(String [] args) { 
int X = 1; 
while ( X < 10 ) { 
X = X + 1; 
^ if ( X > 3) { 

System. out. println(^big ^")} 

> 

} Thi5 will compik and run (no output), but 
} without Q line added to the program, it 

would run forever in on infinite 'while' loop! 



if (X > 2) ( 

System, out * print ( ''a" ) ; 

} 

X = X - 1; 

System. out *print C-" ) ; 

if (X == 2) { 

System- out. print ("b C); 

> 

if (X == 1) { 

System -out .print ( "d") ; 
X = X - 1; 

> 



class Foo { 

public static void iaain(String [J args) { 
int X = 5; 
while { X > 1 ) { 
X = X - 1; 
B if ( X < 3) { 

System. out. println( "small x"); 

) 

} This file won't compile without o 
} class declaration, and don't forget 
) the matching curly brace ! 



java Shufflel 
a-b c-d 



class Exarciaelb { 

public Static void main(5tring [] args) { 

int X = S; 

while ( X > 1 ) { 

X » X - 1; 

if ( X < 3) { 

Syatfliti.oat.println(.''Sniall x' ) ; 

} 

^ The while loop code must be in- 
' side Q method. It cant just be 
^ hanging out inside the doss. 
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puzzle answers 




class PoolPuzzleOne { 

public static void inain(String [] args) { 
int X = 0; 

while i X < A ) { 

System . out . pr Intf q") ; 
if ( X < 1 ) { 

System, out. pHntf "); 

} 

System .out . printfn'^; 

if ( X > 1 ) { 

System, out. prfntC oysteO' 
X = X ♦ 2; 

} 

if ( X == 1 ) { 

System, out. pHntCrvoys*0; 

if ( X < 1 > { 

System . out . prlntC olse'O; 
System. out . println ( " " ) ; 
X = X ♦ 1; 



} 



> 



} 



•ojava PcolPuzzlcOne 
a noise 
annoys 
an oyster 
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class Test { 

public static void main (String [] args) ( 
int X = 0; 
int y - 0; 
while ( X < 5 > ( 



System. out. print [X + 
X = X + 1; 



Rosslblt output: 
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classes and objects 



A Trip to Objectville 




I was told there would be objects, in chapter 1,we put allofour code in the 
mainO method. That's not exactly object-oriented. In fact, that's not object-oriented at all. Well, 
we did use a few objects, like the String arrays for the Phrase-O-Matic, but we didn't actually 
develop any of our own object types. So now we've got to leave that procedural world behind, 
get the heck out of mainO, and start making some objects of our own. We'll look at what makes 
object-oriented (00) development in Java so much fun. We'll look at the difference between 
a class and an object. We'll look at how objects can give you a better life (at least the program- 
ming part of your life. Not much we can do about your fashion sense). Warning: once you get 
to Objectville, you might never go back. Send us a postcard. 
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once upon a time in Objectville 




Chair Wars 

(or How Objects Caw Change Your Life) 

nee upon a time in a software shop, two 
programmers were given the same spec and told to 
"build it". The Really Annoying Project Manager 
forced the two coders to compete, 
by promising that whoever delivers 
first gets one of those cool Aeron^^ 
chairs all the Silicon Valley guys have. 
Larry, the procedural programmer, and 
Brad, the OO guy, both knew this would 
be a piece of cake. 

Larry, sitting in his cube, thought to 
himself, "What are the things this program 
has to do} What procedures do we need?". 
And he answered himself , "rotate and 
playSound." So off he went to build the 
procedures. After all, what is a program if not 
a pile of procedures? 

Brad, meanwhile, kicked back at the cafe 
and thought to himself, "What are the things 
in this program... who are the key players?'' He 
first thought of The Shapes. Of course, there 
were other objects he thought of like the User, the Sound, 
and the Clicking event. But he already had a library of code 
for those pieces, so he focused on building Shapes. Read 
on to see how Brad and Larry built their programs, and 
for the answer to your burning question, "So, who got the 
Aeronf 




In Larry's cube 

As he had done a gazillion times before, Larry 
set about writing his Important Procedures. 
He wrote rotate and playSound in no time, 
r o ta te ( shapeNiam) { 

// make the shape rotate 360° 

} 

playSound (shapeNiam) { 

// use shapeNiam to lookup which 
// AIF sound to play, and play it 

} 



At Prad's laptop at the cafe 

Brad wrote a class for each of the three shapes 



Square 


rotateO { 

// code to rotate a s 
} 

playSoundQ { 
// code to play the 
// for a square 


Circle 


rotateO { 

// code to rotate a c 
} 

playSoundQ { 
// code to play the f 
II for a circle 

} 


Triangle 


rotateO { 

// code to rotate a triangle 

' 

playSoundQ { 
//code to play the AIF file 





// for a triangle 
} 
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classes ^'^^ objects 



Larry thought he'd nailed it. He could almost feel the rolled 
steel of the AeroM beneath his... 

Put wait! There's been a spec change. 

"OK, technically you were first, Larry," said the Manager, "but we have to add just one 
tiny thing to the program. It'll be no problem for crack programmers like you two." 

"If I had a dime for every time Fve heard that one'\ thought Larry, knowing that spec- 
change-no-problem was a fantasy. "And yet Brad looks strangely serene. What's up with 
thatV Still, Larry held tight to his core belief that the OO way, while cute, was just 
slow. And that if you wanted to change his mind, you'd have to pry it from his cold, 
dead, carpal-tunnelled hands. — ^ 




what got added to the spec 



Pack iw Larry's cube 



At Prad's laptop at the beach 



The rotate procedure would still work; the code used 
a lookup table to match a shapeNum to an actual 
shape graphic. But play Sound would have to change. 
And what the heck is a .hif file? 



Brad smiled, sipped his margarita, and wrote one 
new class. Sometimes the thing he loved most 
about OO was that he didn't have to touch code 
he'd already tested and delivered. "Flexibility, 
extensibility,..." he mused, reflecting on the 
benefits of OO. , , 



playSound ( shapeNiam) { 



// if the shape is 
// use shapeNiam 
// AIF sound to 



not an amoeba^ 
to lookup which 
play, and play it 



rotateO { 

// code to rotate an amoeba 



Amoeba 



// else 



// play amoeba 



hif sound 



It turned out not to be such a big deal, but it still 
made him queasy to touch previously-tested code. Of 
a// people, he should know that no matter what the 
project manager says, the spec always changes. 



playSoundO { 
// code to play the new 
// .hif file for an amoeba 
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once upon a time in Objectville 



Larry SMUck in just woweMts ahead of Prad. 

(Hah! So much for that foofy OO nonsense). But the smirk on Larry's face melted when the 
Really Annoying Project Manager said (with that tone of disappointment), "Oh, no, thats not 
how the amoeba is supposed to rotate..." 

Turns out, both programmers had written their rotate code like this: 

1) determine the rectangle that surrounds the shape 

2) calculate the center of that rectangle, and rotate the shape around that point. 

But the amoeba shape was supposed to rotate around a point on one end, like a clock hand. 

"I'm toast." thought Larry, visualizing charred Wonderbread^^. "Although, hmmmm. I could 
just add another if/else to the rotate procedure, and then just hard-code the rotation point 
code for the amoeba. That probably won't break anything." But the little voice at the back of 
his head said, "Big Mistake. Do you honestly think the spec wont change again?" 




What the spec cohvewiehtly 
forgot to mewtioh 



Pack iw Larry's cube 

He figured he better add rotation point arguments 
to the rotate procedure. A lot of code was affected. 
Testing, recompiling, the whole nine yards all over 
again. Things that used to work, didn't. 

rotate (shapeNiam, xPt, yPt) { 
// if the shape is not an amoeba, 

// calculate the center point 

// based on a rectangle, 

// then rotate 
// else 

// use the xPt and yPt as 

// the rotation point offset 

// and then rotate 

} 



Amoeba 



At Prad's laptop ow his laww 
chair at the Telluride Wuegrass Festival 

Without missing a beat. Brad modified the rotate 
method, but only in the Amoeba class. He never 
touched the tested, working, 
compiled code for the other 
parts of the program. To 
give the Amoeba a rota- 
tion point, he added an 
attribute that all Amoebas 
would have. He modi- 
fied, tested, and delivered 
(wirelessly) the revised 
program during a single 
Bela Fleck set. 



int xPoint 
int yPoint 
rotateO { 

// code to rotate an amoeba 
// using amoeba's x and y 
} 

playSoundO { 
// code to play the new 
// .hif file for an amoeba 
} 
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classes objects 



So, Prad the 00 guy got the chair: right? 

Not so fast. Larry found a flaw in Brad's approach. And, 
since he was sure that if he got the chair he'd also get Lucy 
in accounting, he had to turn this thing around. 

LARRY: You've got dupHcated code! The rotate 
procedure is in all four Shape things. 

BRAD: It's a method, not a procedure. And they're classes, 
not things. 

LARRY: Whatever. It's a stupid design. You have to 
maintain /o?ir different rotate "methods". How can that 
ever be good? 

BRAD: Oh, I guess you didn't see the final design. Let me 
show you how OO inheritance works, Larry. 




What Larry wahtcd ^ 
(figured the chair would impress her) 




Amoeba 



rotateO 
playSoundQ 



O 



Hooked at what all four 
classes have ih commoh. 



They're Shapes, awd they all rotate awd 
playSouhd. So I abstracted out the 
commoh features awd put them ihto a 
hew class called Shape. 




superclass 



You can read this as, "Square inherits from Shape", 
"Circle inherits from Shape", and so on. I removed 
rotateO and playSound() from the other shapes, so now 
there's only one copy to maintain. 

The Shape class is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses inherit the methods of the superclass. In other 
words, if the Shape class has the functionality, then the 
subclasses automatically get that same functionality 





subclasses 



Theh I lihked the other 
four shape classes to 
the hew Shape class, 
ih a relationship called 
ihheritawce. 




Triangle 



you are here ► 



31 



once upon a time in Objectville 

What about the Amoeba rotatcO? 

LARRY: Wasn't that the whole problem here — that the amoeba shape 



had a completely different rotate and playSound procedure? 
BRAD: Method. 

LARRY: Whatever. How can amoeba do something different if 
it "inherits" its functionality from the Shape class? 

BRAD: That's the last step. The Amoeba class overrides the 




methods of the Shape class. Then at runtime, the JVM knows exactly 
which rotate 0 method to run when someone tells the Amoeba to rotate. 



superclass 
(more abstract) 



Shape 



rotateO 
playSoundQ 



subclasses 
(more specific) 



Square 



LARRY: How do you "tell" an Amoeba to 
do something? Don't you have to call the 
procedure, sorry — method, and then tell it 
which thing to rotate? 

BRAD: That's the really cool thing about OO. 
When it's time for, say, the triangle to rotate, 
the program code invokes (calls) the rotate () 
method on the triangle object. The rest of the 
program really doesn't know or care how the 
triangle does it. And when you need to add 
something new to the program, you just write 
a new class for the new object type, so the new 
objects will have their own behavior. 



O 




Amoeba 



rotateO { 

// amoeba-specific 
// rotate code } 

playSoundQ { 

// amoeba-specific 
// sound code } 



I made the Amoeba class override 
the rotateO ahd playSouhdO 
methods of the superclass Shape. 

Overridmg just meaws that a 
subclass redef mes ohe of its 
inherited methods when it heeds 
to chawge or extewd the behavior 
of that method. 



Overridihg methods 
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The suspense is killing me. 
Who got the chair? 




Amy from the second floor. 

(unbeknownst to all, the Project 
Manager had given the spec to 
three programmers.) 



What do you like about 00? 



"It helps me design in a more natural way. Things 
have a way of evolving." 

-Joy, 27, software architect 



"Not messing around with code I've already 
tested, just to add a new feature." 

-Brad, 32, programmer 



"I like that the data and the methods that oper- 
ate on that data are together in one class." 

-Josh, 22, beer drinker 

"Reusing code in other applications. When I write 
a new class, I can make it flexible enough to be 
used in something new, later." 

-Or\r'\s, 39, project manager 



classes ^'^^ objects 




Time to pump some neurons. 

You just read a story bout a procedural 
programmer going head-to-head with an 00 
programmer. You got a quick overview of some 
key 00 concepts including classes, methods, and 
attributes. We'll spend the rest of the chapter 
looking at classes and objects (we'll return to 
inheritance and overriding in later chapters). 

Based on what you've seen so far (and what you 
may know from a previous 00 language you've 
worked with), take a moment to think about 
these questions: 

What are the fundamental things you need to 
think about when you design a Java class? What 
are the questions you need to ask yourself? 
If you could design a checklist to use when 
you're designing a class, what would be on the 
checklist? 



"I can't believe Chris just said that. He hasn't 
written a line of code in 5 years." 

-Daryl, 44, works for Chris 



"Besides the chair?" 



-Amy, 34, programmer 




If you're stuck on an exercise, try talking about 
it out loud. Speaking (and hearing) activates 
a different part of your brain. Although it 
works best if you have another person to 
discuss it with, pets work too. That's how 
our dog learned polymorphism. 
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thinking about objects 



Whew you design a class, think about the objects that 
will be created from that class type. Think about: 

■ things the object knows 

■ things the object does 



ShoppingCart 



cartContents 



addToCartO 
remove FromCartO 
checkOutO 



knows 
does 



Button 



label 
color 



setColorO 
setLabelO 
dePressO 
unDepressO 



knows 
does 



Alarm 



alarmTime 
alarmMode 



setAlarmTimeO 
getAlarmTimeO 
isAlarmSetO 
snoozeO 



knows 



does 



Things an object knows about itself are called 

■ instance variables 

Things an object can do din called 

■ methods 



instance 
variables 

(state) 

methods 

(behavior) 




Things an object knows about itself are called instance 
variables. They represent an object's state (the data), and 
can have unique values for each object of that type. 

Think of instance as another way of saying object. 

Things an object can do are called methods. When you 
design a class, you think about the data an object will need 
to know about itself, and you also design the methods 
that operate on that data. It's common for an object to 
have methods that read or write the values of the instance 
variables. For example. Alarm objects have an instance 
variable to hold the alarmTime, and two methods for 
getting and setting the alarmTime. 

So objects have instance variables and methods, but those 
instance variables and methods are designed as part of the 
class. 



-^rpen your pencil 



Fill in what a television object 
might need to know and do. 





iHstahce 
variables 



methods 
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classes objects 



What's the difference between 
a class and an object? 




many objects 



A class is not ah object, 
(but it's used to construct tbcw) 

A class is a blueprint for an object. It tells the 
virtual machine how to make an object of that 
particular type. Each object made from that 
class can have its own values for the 
instance variables of that class. For 
example, you might use the Button 
class to make dozens of different 
buttons, and each button might have 
its own color, size, shape, label, and so on. 



JVM 




LookatitAiswav... 



qTT\_ 



2l 



Mopi*^ / L - M 

IT Unm« Vd\X. 



V 



A 



Name ^pL^-H M^rfi^w. 
Phone 555-0^^^ 



An object is like one entry in your address book. 

One analogy for objects is a packet of unused Rolodex™ cards. 
Each card has the same blank fields (the instance variables). When 
you fill out a card you are creating an instance (object), and the 
entries you make on that card represent its state. 

The methods of the class are the things you do to a particular card; 
getName( ), changeName( ), setName( ) could all be methods for 
class Rolodex. 

So, each card can do the same things (getName( ), changeName( ), 
etc.), but each card knows things unique to that particular card. 
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making objects 



Making your first object 



So what does it take to create and use an object? You need two classes. One 
class for the type of object you want to use (Dog, AlarmClock, Television, 
etc.) and another class to ^^-^^your new class. The ^^-^^^r class is where you put 
the main method, and in that main() method you create and access objects 
of your new class type. The tester class has only one job: to try out the meth- 
ods and variables of your new object class type. 

From this point forward in the book, you'll see two classes in many of 
our examples. One will be the rm/ class - the class whose objects we 
really want to use, and the other class will be the tester class, which we 
call <whateverYourClassNameIs> TestDrive. For example, if we make a 
Bungee class, we'll need a BungeeTestDrive class as well. Only the 
<someClassName>']l&stDri.-v& class will have a main() method, and its sole 
purpose is to create objects of your new type (the not-the-tester class), and 
then use the dot operator (.) to access the methods and variables of the new 
objects. This will all be made stunningly clear by the following examples. 



Write your class 

class Dog { 



int size; 
String breeds- 
String name; 

void bark ( ) { 



^ •method 



DOG 



size 

breed 

name 



barkO 



System, out. print In (''Ruff! Ruff!") ; 



O 



The Dot Operator (.) 

The dot operator (.) gives 
you access to an object's 
state and behavior (instance 
variables and methods). 



// make a new object 
Dog d = new DogO; 



// tell it to bark by using the 
// dot operator on the 
// variable d to call bark() 

d.barkO; 

// set its size using the 
// dot operator 

d.size = 40; 



Write a tester (TestDrive) class 



class DogTestDrive { 

^ public static void main ( String [] 
// Dog test code goes here 



args) { 



} 



} 



O 



In your tester, make an object and access 
the object s variables and methods 



class DogTestDrive { 

public static void main (String [] args) { 

Dog d = new Dog() ; < . "^^^^ ^ Dog otj^^^ 

d . size = 40 ; ^ 




barkO ; 



^ i\st doi oYtYaioY O 



If you already have some 00 savvy, 
you'll know we're not using encapsulati 
We'll get there In chapter 4. 



■ion. 
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classes ^'^^ objects 



Making and testing Movie objects 




class Movie { 
String titled- 
String genre; 
int ratings- 
void playltO { 

System, out .print In (^^ Playing the movie") ; 



} 



} 



piiblic class MovieTestDrive { 

public static void main (String [] args) { 
Movie one = new Movie ( ) ; 
one. title = ^^Gone with the Stock" ; 
one. genre = ^^Tragic"; 
one . rating = -2 ; 
Movie two = new Movie ( ) ; 
two. title = ^^Lost in Cubicle Space" ; 
two . genre = Comedy" ; 
two . rating = 5 ; 
two.playltO ; 

Movie three = new Movie ( ) ; 
three . title = ^^Byte Cl\ib" ; 

three. genre = ^^Tragic but ultimately uplifting" 
three. rating = 127; 



} 



} 




object 1 



title 

genre 

rating 



)enMij|;^ncil 



The MovieTestDrive class creates objects (instances) of 
the Movie class and uses the dot operator (.) to set the 
instance variables to a specific value. The MovieTestDrive 
class also invokes (calls) a method on one of the objects. 
Fill in the chart to the right with the values the three 
objects have at the end of mainO. 



object 2 



title 

genre 

rating 



object 3 
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get the heck out of main 

Quick! &et out of main! 

As long as you're in main(), you're not really in Objectville. It's fine for a test 
program to run within the main method, but in a true OO application, you 
need objects talking to other objects, as opposed to a static main() method 
creating and testing objects. 



The two uses of main: 

■ to test your real class 

■ to launch/start your Java application 

A real Java application is nothing but objects talking to other objects. In this 
case, talking me^LYis objects calling methods on one another. On the previous 
page, and in chapter 4 , we look at using a main() method from a separate 
TestDrive class to create and test the methods and variables of another class. In 
chapter 6 we look at using a class with a main() method to start the ball rolling 
on a rm/Java application (by making objects and then turning those objects 
loose to interact with other objects, etc.) 

As a 'sneak preview', though, of how a real Java application might behave, 
here's a little example. Because we're still at the earliest stages of learning Java, 
we're working with a small toolkit, so you'll find this program a little clunky 
and inefficient. You might want to think about what you could do to improve 
it, and in later chapters that's exactly what we'll do. Don't worry if some of the 
code is confusing; the key point of this example is that objects talk to objects. 

The Guessing ^ame 

Summary: 

The guessing game involves a 'game' object and three 'player' objects. The game gen- 
erates a random number between 0 and 9, and the three player objects try to guess 
it. (We didn't say it was a really exciting game.) 



Classes: 

GuessGame . class 



Player . class GameLauncher . class 



The Logic: 

1 ) The GameLauncher class is where the application starts; it has the main () method. 

2) In the main () method, a GuessGame object is created, and its startGameO method 
is called. 

3) The GuessGame object's startGameO method is where the entire game plays out. 
It creates three players, then "thinks" of a random number (the target for the players 
to guess). It then asks each player to guess, checks the result, and either prints out 
information about the winning player(s) or asks them to guess again. 



GameLauncher 



main(StringO args) 



GuessGame 



p1 
P2 
P3 



StartGameO 
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public class GuessGame { 

Player pi; 
Player p2; 
Player p3; 

public void startGame ( ) 
pi = new Player 0; 
p2 = new Player 0; 
p3 = new Player 0; 

int guesspl = 0; 
int guessp2 = 0; 
int guessp3 = 0; 

boolean plisRight 
boolean p2isRight 
boolean p3isRight 



-i'^eaie W Player obiedt a^d 



ICS 



_ declare thircc vav^iablcs -to hold the 
thircc guesses the Playev-s r.ake 

aise; ^T^ i^f^""^ ^^^'^bles "to hold 3 tv-ue ov- 

al se; '^^'^^ ''^scd o}r\ -the playev-s a^sy/ev- 



int targetNumber = (int) (Math . random ( ) * 10); 

System, out .println (^^I'm thinking of a number between 0 and 9. 

while (true) { 

System, out .println (^^Number to guess is 



rrjake a 'tairget' hur».bev- that the 
playe\rs have to guess 



pi . guess ( ) ; 
p2 . guess ( ) ; 
p3 . guess ( ) ; 



+ targetNumber) 

tall eath playev's guessO method 



guesspl = pi. number; 

System . out . println (^^Player one guessed + guesspl), 
guessp2 = p2. number; 

System . out . println (^^Player two guessed + guessp2), 

guessp3 = p3. number; 
System . out . println (^^Player three guessed + guessp3) , 



get ea^th players guess (the v-esult o^ thei^ 
guess(; n^ethod \ruhhihg) by a^t^iessmg the 
K^umbe\r va\riable o( cat\\ player 



if 

} 

if 



(guesspl = 
plisRight 



(guessp2 = 
p2isRight 

} 

if (guessp3 = 
p3isRight = 

} 



= targetNumber) 
= true; 

= targetNumber) 
= true; 

= targetNumber) 
true; 



^hed ea^ih players guess to see it ^aithts 
the ta\rget hun.be\r. |+ a playev- is v-ight, 
theh set that playev-s vav-iable to be tv-ue 
(\reii.er».be\r, we set it -false by default) 



if (plisRight | | p2isRight | | p3isRight) 



(the II opevatov meaw OR) ^ 



System, out .println (^^We have a winner!''); 
System, out .println (^^Player one got it right? 
System, out .println (^^Player two got it right? 
System, out .println (^^Player three got it right: 
System, out .println (^^Game is over.''); 
break; jt of the loop 

} else { 

^'^ep going because nobody got 
System, out .println (^''Players will have to try again."); 
} // end if/else 
} / / end loop 
} / / end method 
// end class 



ope\ra 

+ plisRight) ; 
+ p2isRight) ; 
+ p3isRight) ; 
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Guessing Game 

Running the Guessing &ame 

public class Player { 

int number =0; // where the guess goes 

public void guess () { 

number = (int) (Math . random ( ) * 10); 

System.out .println (''I'm guessing '' I File Edit Window Help Explode 

+ number) ; 



Output (it will be different each time you run It) 




public class GameLauncher { 

public static void main (String [] args) { 
GuessGame game = new GuessGameO; 
game . startGame ( ) ; 



Java takes out the 
Garbage 

Each time an object is created 
in Java, it goes into an area of 
memory known as The Heap. 
All objects — no matter when, where, 
or how they're created - live on the 
heap. But it's not just any old memory 
heap; the Java heap is actually called the 
Garbage-Collectible Heap. When you 
create an object, Java allocates memory 
space on the heap according to how 
much that particular object needs. An 
object with, say, 1 5 instance variables, 
will probably need more space than an 
object with only two instance variables. 
But what happens when you need to 
reclaim that space? How do you get an 
object out of the heap when you're done 
with it? Java manages that memory 
for you! When the JVM can 'see' that an 
object can never be used again, that 
object becomes eligible for garbage 
collection. And if you're running low on 
memory, the Garbage Collector will run, 
throw out the unreachable objects, and 
free up the space, so that the space can 
be reused. In later chapters you'll learn 
more about how this works. 



%java GameLauncher 
I'm thinking of a number between 0 and 9. . . 
Number to guess is 7 
I'm guessing 1 
I'm guessing 9 
I'm guessing 9 
Player one guessed 1 
Player two guessed 9 
Player three guessed 9 
Players will have to try again. 
Number to guess is 7 
I'm guessing 3 
I'm guessing 0 
I'm guessing 9 
Player one guessed 3 
Player two guessed 0 
Player three guessed 9 
Players will have to try again. 
Number to guess is 7 
I'm guessing 7 
I'm guessing 5 
I'm guessing 0 
Player one guessed 7 
Player two guessed 5 
Player three guessed 0 
We have a winner! 
Player one got it right? true 
Player two got it right? false 
Player three got it right? false 
Game is over. 
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Dumb Questions 

What if I need global 
variables and methods? How 
do I do that if everything has to 
go in a class? 



A: 



There isn't a concept of 
'global'variables and methods in 
a Java 00 program. In practical 
use, however, there are times 
when you want a method (or 
a constant) to be available 
to any code running in any 
part of your program. Think 
of the random ( ) method in 
the Phrase-O-Matic app; it's a 
method that should be callable 
from anywhere. Or what about 
a constant like p/? You'll learn 
in chapter 10 that marking 
a method as public and 
static makes it behave much 
like a 'global'. Any code, in any 
class of your application, can 
access a public static method. 
And if you mark a variable as 
public, static, and final 
- you have essentially made a 
globally-available constant. 



Then how is this object- 
oriented if you can still make 
global functions and global 
data? 



A: 



L- First of all, everything 
in Java goes in a class. So the 
constant for pi and the method 
for random ( ) , although both 
public and static, are defined 
within the Math class. And you 
must keep in mind that these 
static (global-like) things are the 
exception rather than the rule 
in Java. They represent a very 
special case, where you don't 
have multiple instances/objects. 



What is a Java program? 
What do you actually deliverl 



A: 



L- A Java program is a pile 
of classes (or at least one class). 
In a Java application, one of 
the classes must have a main 
method, used to start-up the 
program. So as a programmer, 
you write one or more classes. 
And those classes are what you 
deliver. If the end-user doesn't 
have a JVM, then you'll also 
need to include that with 
your application's classes, / 
so that they can run your 
program. There are a number 
of installer programs that 
let you bundle your classes 
with a variety of JVM's (say, for 
different platforms), and put it all 
on a CD-ROM. Then the end-user 
can install the correct version of 
the JVM (assuming they don't 
already have it on their machine.) 



What if I have a hundred 
classes? Or a thousand? Isn't 
that a big pain to deliver 
all those individual files? 
Can I bundle them into one 
Application Thing! 



A: 



L- Yes, it would be a big 
pain to deliver a huge bunch of 
individual files to your end-users, 
but you won't have to. You can 
put all of your application files 
into a Java Archive - a .jar file - 
that's based on the pkzip format. 
In the jar file, you can include 
a simple text file formatted as 
something called a /r?an/fesf,that 
defines which class in that jar 
holds the main() method that 
should run. 




(ho(olaie Chip CooKie^ ^^ok/es, 




iifyO ^» 

'^^'^s is /ike a recipe 
Obiectsare/ifce 



BULLET POINTS 

Object-oriented programming lets you extend 
a program without having to touch previously- 
tested, working code. 
All Java code is defined in a class. 
A class describes how to make an object of 
that class type. A class is like a blueprint. 
An object can take care of itself; you don't 
have to know or care how the object does it. 
An object knows things and does things. 
Things an object knows about itself are called 
instance variables. They represent the state 
of an object. 

Things an object does are called methods. 
They represent the behavior of an object. 
When you create a class, you may also want 
to create a separate test class which you'll 
use to create objects of your new class type. 
A class can inherit instance variables and 
methods from a more abstract superclass. 

At runtime, a Java program is nothing more 
than objects 'talking' to other objects. 
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exercise: Be the Compiler 



BE ih^ com]f iler 

EacK of {ke Java files on fliis page 
represents a complete source file. 
Your job is to play compiler and 

determine wKeflier eacK of 
Aese files will compile. 
If lliey won't compile, 
Kow would you fix Aem, 
and if lliey do compile, 
wKat would he fieir output? 




A 

class TapeDeck { 

boolean canRecord = false; 

void playTape ( ) { 

System, out .println (''tape playing'') ; 

} 

void recordTape ( ) { 

System, out .println (''tape recording'') ; 

} 

} 

class TapeDeckTestDrive { 

public static void main (String [] args) { 

t. canRecord = true; 
t .playTape ( ) ; 

if (t. canRecord == true) { 
t . recordTape ( ) ; 

} 

} 

} 
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class DVDPlayer { 

boolean canRecord = false; 

void recordDVDO { 

System. out .println ("DVD recording") ; 

} 

} 

class DVDPlayerTestDrive { 

public static void main (String [] args) { 

DVDPlayer d = new DVDPlayer (); 
d. canRecord = true; 
d.playDVDO ; 

if (d. canRecord == true) { 
d.recordDVD 0 ; 

} 

} 

} 



ff!^ Code Magnets 



classes objects 




A Java program is all scrambled up on 
the fridge. Can you reconstruct the 
code snippets to make a working Java 
program that produces the output listed 
below? Some of the curly braces fell on 
the floor and they were too small to pick 
up, so feel free to add as many of those 
as you need. 



d.playSnare () ; 



DrumKit d = new DrumKit ( 



boo 



lean topHat 



boolean snare 



= true; I 



void playSnare ( ) { 

System, out. println(^^bang bang ba-bang") ; 

} 



public static void main (String [] args) 
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% java DrumKitTes tDrive 
bang bang ba-bang 
ding ding da-ding 



puzzle: Pool Puzzle 




P<3@] 'Puzzle 




Your job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
make classes that will compile and 
run and produce the output listed. 



Output 



%java EchoTestDrive 
helloooo. . . 
helloooo. . . 
helloooo. . . 
helloooo. . . 



public class EchoTestDrive { 

public static void main (String [] args) 
Echo el = new Echo(); 



int X = 0; 
while ( 



) { 



el.helloO ; 



if ( 



) { 



e2. count = e2 . count + 1; 



if ( 



) { 



e2. count = e2 . count + el. count; 



X = X + 1; 

} 

System. out .println (e2 . count) ; 



Bonus Question ! 

If the last line of output was 
24 instead of 10 how would 
you complete the puzzle ? 



class 
int 
void 



0; 

_ { 



System, out .println ( '^''helloooo . 



el =e1 + 1; 
el = count + 1; 
el. count = count + 1; 
el. count = el. count + 1 



Note: Each snippet 
from the pool can be 
used more than once! 




e2 = e1; 
Echo e2; 
Echoe2 = e1; 
Echo e2 = new Echo( ); 



x==3 
x==4 
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A bunch of Java components, in full costume, are playing a party 
game, "Who am I?" They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say something that could be true 
for more than one of them, choose all for whom that sentence can 
apply. Fill in the blanks next to the sentence with the names of one or 
more attendees. The first one's on us. 

Tonight's attendees: 

Class Method Object Instance variable 



I am compiled from a Java file. diass 



My instance variable values can 
be different from my buddy's 
values. 



I behave like a template. 

I like to do stuff. 

I can have many methods. 

I represent *state'. 

I have behaviors. 

I am located in objects. 

I live on the heap. 

I am used to create object instances. 

My state can change. 

I declare methods. 

I can change at runtime. 
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^^^^ 



Exercise Solu&ons 



Code Magnets: 

class DrumKit { 

boolean topHat = true; 
boolean snare = true; 

void playTopHatO { 

System . out . print In ( ""Ming ding da-ding"); 



void playSnareO { 

System . out . print In ( ""^bang bang ba-bang") ; 



} 



} 



class DrumKitTestDrive { 

public static void main (String [] args) { 

DrumKit d = new DrumKit (); 
d . playSnare ( ) ; 
d. snare = false; 
d.playTopHat ( ) ; 

if (d. snare == true) { 
d . playSnare ( ) ; 

} 



% java DrumKitTestDrive 
bang bang ba-bang 
ding ding da-ding 



Be the Compiler: 

class TapeDeck { 

boolean canRecord = false; 
void playTape ( ) { 

System, out .println (''tape playing'') ; 

} 

void recordTape ( ) { 

System, out .println (''tape recording'') ; 



} 



class TapeDeckTestDrive { 

public static void main (String [] args) 

TapeDeck t = new TapeDeck( ); 

t. canRecord = true; 
t .playTape ( ) ; 

if (t. canRecord == true) { 
t . recordTape ( ) ; 



} 



We've got the template, now we have 
to make an object ! 



B 



class DVDPlayer { 

boolean canRecord = false; 
void recordDVD ( ) { 

System. out .println ("DVD recording") ; 

} 

void pIcyDVD ( ) { 

System.out.printlnfDVD ploying"); 

} 



class DVDPlayerTestDrive { 

public static void main (String [] args) 
DVDPlayer d = new DVDPlayer (); 
d. canRecord = true; 
d.playDVDO ; 

if (d. canRecord == true) { 
d. recordDVD 0 ; 



The line: d.playDVD( ); wouldn't 
compile without a method I 
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puzzle Solutions 



Pool Puzzle 



public class EchoTestDrive { 

public static void main (String [] args) { 
Echo el = new Echo(); 

Echo eZ = new Echo( ); // the correct answer 
- or - 

Echo e2 - el; // is the bonus answerl 

int X = 0; 
while ( X < 4 ) { 
el .hello 0 ; 

el.count = el.count + 1; 

if ( X 3 ) { 

e2 . count = e2 . count + 1; 

} 

if ( X > 0 ) { 

e2. count = e2 . count + el.count; 

} 

X = X + 1; 

} 

System. out .print In (e2 . count) ; 



class Echo { 
int count = 0; 
void helloO { 

System . out . print In ( """^helloooo . . , 

} 



I am compiled from a Java file. 



didss 



My instance variable values can be 
different from my buddy's values. oW\tti 



I behave like a template. 

I like to do stuff. 

I can have many methods. 

I represent *state'. 

I have behaviors. 

I am located in objects. 

I live on the heap. 

I am used to create object 
instances. 

My state can change. 

I declare methods. 

I can change at runtime. 



t\ass 

mstan^c vav-iablc 
object, t\ass 

mciKodi, mstan^c vav-iablc 
object 

diass 

object ms-tarvdc vaviabic 
t\ass, 

object, ms-tandc variable 



Note: both classes and objects are said to have state and behavior. 
They're defined in the class, but the object is also said to 'have' 
them. Right now, we don't care where they fechnicaily live. 
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%java EchoTestDrive 
helloooo . . . 
helloooo . . . 
helloooo . . . 
helloooo . . . 
10 



3 primitives and references 



Know Your Variables 




Variables come in two flavors: primitive and reference, sofaryouve 

used variables in two places— as object state (instance variables), and as local variables 
(variables declared within a mef/iocfl. Later, we'll use variables as arguments (values sent to a 
method by the calling code),and as return types (values sent back to the caller of the method). 
You've seen variables declared as simple primitive integer values (type int). You've seen 
variables declared as something more complex like a String or an array. But there's gotta be 
more to life than integers, Strings, and arrays. What if you have a PetOwner object with a Dog 
instance variable? Or a Car with an Engine? In this chapter we'l) unwrap the mysteries of Java 
types and look at what you can declare as a variable, what you can put in a variable, and what you 
can do with a variable. And we'll finally see what life is truly like on the garbage-collectible heap. 
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declaring a variable 




Peclariiig a variable 

Java cares about type. It won't let you do 
something bizarre and dangerous like stuff a 
Giraffe reference into a Rabbit variable — what 
happens when someone tries to ask the so-called 
Rabint to hop ( ) ? And it won't let you put a 
floating point number into an integer variable, 
unless you acknowledge to the compiler xhzt you 
know you might lose precision (like, everything 
after the decimal point). 

The compiler can spot most problems: 

Rabbit hopper = new Giraffe () ; 

Don't expect that to compile. Thankfully. 

For all this type-safety to work, you must declare 
the type of your variable. Is it an integer? a Dog? 
A single character? Variables come in two flavors: 
primitwe ztlA object reference. Primitives hold 
flindamental values (think: simple bit patterns) 
including integers, booleans> and floating point 
numbers. Object references hold, well, rrfermces 
to objects (gee, didn*t that clear it up.) 

We'll look at primitives first and then move 
on to what an object reference really means. 
But regardless of the type, you mtist follow two 
declaration niles: 

variables must have a type 

Besides a type, a variable needs a name, so that 
you can use that name in code, 

variables must have a name 



int count; 



Note: When you see a statement like: ''an object 
of type X", think o( type2Jid c/os^ as synonyms. 
(We'll refine that a little more in later chapters.) 
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Ti [Ike a double mocha, no. make it an mV 

ou think of Java variables, think of cups. CofiFee cups, tea cups, giant 
it hold lots and lots of beer, those big cups the popcorn comes in at 
fcies, cups with curvy, sexy handles, and cups with metallic trim that 
riearned can never, ever go in the microwave. 

I, lartable is just a cup. A container. It hoMs something. 

ihx; a size, and a type. In this chapter, we're going to look first at the 
>les (cups) that hold primitives, then a Jitde later we*ll look at cups 
[ hold refemices to objects. Stay with us here on the whole cup analogy — as 
lie as it is right now, it'll give us a common way to look at things when 
p discussion gets more complex. And that*ll happen soon. 

aitives are like the cups they have at the coffeehouse. If youVe been to a 
jcks, you know what we're talking about here. They come in different 
[ each has a name like 'short*, 'tail', and, like a 
5' mocha half-caff with extra whipped cream". 

^hi see the cups displayed on the counter, 
Tcan order appropriately: 




smal! short 



gronde 



And in Java, primitives come in different sizes, and those sizes 
have names. When you declare a variable in Java, 

j^ou must declare it with a specific type. The 
four containers here are for the four 
integer primitives in Java. 




long 

I cup holds a value, so for Java primitives, rather than saying, Td like a 
Ifrench roast", you say to the compiler, "Vd like an int variable with the 
tr 90 please.** Except for one tiny difference... in Java you also have to 
>ur cup a nam£. So it's actually, "Vd like an int please, with the value 
5, and name the variable hei^"* Each primitive variable has a fixed 
of bits (cup size) . The sizes for the six numeric primitives in Java 
below; 





byte short int long 
8 16 32 64 



float double 
32 64 



Primitive Types 

Type Bit Depth Value Range 
boolean and char 

boolean avMipedfic) true ot false 
char 16 bits 0 to 65535 

numeric (all are signed) 

byte 8 bits -128 to 127 
short 16 bits 



-32768 to 
32767 



int 



32 bits -21 47463646 
to 2147483647 
long 64 bits -huge to huge 

floating point 

float 32 bits varies 
double 64 bits varies 

Primitive deciaratlons 
with assignments; 

intx; 

X = 234; 

byte b = 89; 

boolean isFun = true; 

double d ^ 3456.98; 

charc = r; 

int z = x; 

boolean isPunlcRock; 
isPunkRock = faise; 
booiean powerOn; 
powerOn = isFun; 
long big = 3456789; 
float f = 32.5^ 
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You really don't want to spill that... 

Be sure the value can fit into the variable. 



You can*t put a large value into a 
small cup. 

Well, OK, you czn, but you'll 
lose some. You'll get, as we say, 
spilktge. The compiJer tries to 
help prevent this if it can tell 
from your code thai something's 
not going to fit in the container 
(variable/cup) you're using. 

For example, you can't pour an 
ini-full of stuff into a byte^ized 
container, as follows: 

int X = 24; 

byte b = x; 

//won' c work ! ! 



Why doesn't this work, you ask? After all, the value of x is 24, and 24 is definitely 
small enough to fit into a byte. You know that, and toe know that, but all the 
compiler cares about is thatyouVe trying to put a big thing into a small thing, 
and there's the possiinUty of spilling. Don't expect the compiier to know what the 
value of xis, even if you happen to be able to see it hterally in your code. 

You can assign a value to a variable in one of several ways including: 

■ type a Ht^alvdlue after the equals sign (x=/2, isGood = true, etc) 

■ assign the value of one variable to another (x = y) 

■ tise an expression combining the two (x = y + ^i) 
In the examples below, the literal values are in bold italics: 





int si2e = 32) 
char initial = ' j' ; 
double d = ^56. 709; 
boolean isCrazy; 
isCrazy = true; 
int y = X + 456; 



declare an int named size, assign it the value 32 

declare a char named initial, assign it the value f 

declare a double named d. assign it the value 456. 709 

declare a boolean named isCrdzy (no assignment) 

assign the value irue to the previously-declared isCrazy 

declare an int named y, assign It the value that is the sum 
of whatever x Is now plus 456 



irpen your pencil 



The compiler won't let you put 
a value from a large cup into 
a small one. But what about 
the other way— pouring a 
small cup into a big one? No 
problem. 

Based on what you know 
about the size and type of the 
primitive variables, see if you 
can figure out which of these 
are legal and which aren't. 
We haven't covered all the 
rules yet so on some of these 
you'll have to use your best 
judgment. T/p; The compiler 
always errs on the side of 
sa fety. 

From the following list Circle 
the statements that would be 
legal if these lines were in a 
single method: 

1. int X = 34.5; 

2. boolean boo = x; 

3. int g = 17; 

4 . int y = g; 

5. Y = y + 10; 

6. short s; 

7. s = y; 

8. byte b 3; 

9 . by ta v = b ; 

10. short n = 12; 

11. V = n; 

12. byte k = 128; 
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fatk away from that keyword! 

know you need a name and a type for your variables. 

already know the primitive types. 

t can you use as names ? The rules are simple. You 
t name a class, method, or variable according to the 
ig rules {the real rules axe slightly more flexible, 
6 these will keep you safe): 

must start with a letter, underscore or 
>llar sign ($). You can^ start a name with a 
number. 

After the first character, you can use numbers as 
ill. Just don*t start It with a number 

It can be anything you like, subject to those two 
^ mlas, Just so long as It lent one of Java's reserved 
»rds. 

t keywords (and other things) that the compiler recognizes 
id if you really want to play confuse-a<ompiler, then just try 
ig a reserved word as a name. 

iVe already seen some reserved words when we looked at 
ig our first main class: j , 

public static void 

. the primitive types are reserved as well: 

boolean char byte short int long float double 

: there are a lot more we haven't discussed yet Even if you don*t 
[ to know what they mean, you still need to know you can't use 
I yourself. Do not-under any circumstances-try to memoriie these 
, To maJke room for these in your head, you'd probably have to 
^ something else. Like where your car is parked. Don*t worry^ by 
fend of the bookyou^JJ have most of them down cold. 



lis table reserved. 



boolean 



byte 



double 



floGi 




Int 



eded 



abslrad 



find 



notrve 



static 



striftfp 



synchronized 



translenl 



volatile 



do 



while 



switch 



(Q$6 



defauK 



for 



break 



CQn1inu6 



assert 



extends 



implements 



imporl 



Instonceof 



interface 



new 



package 



super 



thh 



finaify 



fry 



ttirow 



throws 



return 



void 



const 



goto 



enum 



1 keywords ar\d other reserved words (In no useful order). If you use these for names, the compiler will be very, very upset, 
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CoHtrolling your 9oq object 

You know how to declare a primitive variable and assign it a 
value. But now what about non-primitive variables? In other 
words, what abcmt objects? 



There Is actually no such thing as an object variable. 
There's only an object reference variable. 

An object reference variable holds bits that represent a 
v^ay to access an object 

it do6sn*t hold the object Itse^, but it holds something 
like a pointer Or an address. Except^ in Java we don't 
really l<novt; iv/iatis inside a reference variable. We do 
know that whatever it Is, It represents one and only one 
object And the JVM knows how to use the reference to 
get to the object 



You can't stuff an object into a variable. We often think of 
it that way... we say things like> "I passed the String to tlie 
System,outprintln() method." Or, "The method returns a Dog**, 
or, "I put a new Foo object into the variable named myFoo." 



Dog d = new Dog(); 
d.barkO; 



like iKis^ 



But that's not what happens. There aren't giant 
expandable cups that can grow to the size of any 
object. Objects live in one place and one place 
only — the garbage collectible heap! (You'll 
learn more about that later in this chapter.) 

Although a primidve variable is full of 
bits representing the actual z^aZweof the 
variable, an object reference variable is full 
of bits representing a way togettoUie 
object 

You use the dot operator (.) 
on a reference variable to say, 
"use the thing before the dot to 
get me the thing after dot." For 
example; 

myDog.barkO ; 

means, "use the object referenced by the variable myDog to 
invoke the bark() method." When you use the dot operator on 
an object reference variable, think of it like pressing a button 
on the remote control for that object. 




T>iir\k a 
<A>^€ti ho do i<^»n^tK■lr^Cj 
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byte short 
a 16 




ir\i long reference 
32 64 (bit depth not relevant) 

H object reference is Just 
other variable value. 

lething that goes in a cup. 
ly this time, the value Is a remote control. 

itt(v€ Variable 



X = 7; 

''bits representing 7 go 
the variable. (000001 11) 



byte 




nnte Variable 

inyDog = new Dog() 

bits representing a way to get to 
Dog object go into the variable. 

Dog object itself does not go into 
Yariabiet 



pnmrtive variabias, the volue of the 
is... the vafue {5. -26.7, 'a'). 

reference variobies, the value of the 
bte is». bits represenffng o way to g 
ecf fic object. 

don't know (or care) how any particular 
impiementi obfect references. Sure, they 
be a pointer to o pointer to... biit even 
yon know, you still can't use the bits for 
thing other than accessing an object. 



aew't cara how meny 1 's and Oa there are in a reteranoe variabid irs up lo each 
' lha ptias« of lha mooo. 





The 3 steps of object 
declaration, creation and 
assignment 



1 



Dog n^Dog = new Dog ( ) ; 



Declare a reference 
variable 



Dog myDog = new DogO ; 

Tells the JVM to allocate space for a 
reference variable, and names that 
variable myDog. The reference variable 
is, forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 




Create an object 

Dog myDog ^ new Dog ( ) ; 

Tells the JVM to allocate space for a 
new Dog object on the heap (we'll 
learn a lot more about that process, 
especially in chapter 9.) 



Dog object 



Link the object 
and the reference 

Dog myDog = new Dog ( ) ; 

Assigns the new Dog to the reference 
variable myDog. In other words, 
programs the remote control, 




bog object 
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How big Is a reference 
variable? 



./\^lYou don't know, Unless 
you're cozy with someone on the 
JVM's development team, you 
don't know how a reference is 
represented. There are polriters 
in there somewhere, but you 
can't access them. You won't 
need to.(OKJf you Insist you 
might as well Just Imagine It 
to be a 64-bit value.) But when 
you're taiking about memory 
allocation Issues, your Big 
Concern should be about how 
many objects (as opposed to 
object referencei) you're creating, 
and how big they {the objects) 
really are. 



So, does that mean that 
all object references are the 
same siz^ regardless of the size 
of the actual objects to which 
they refer? 

j/\^!Yep.AII references for a 
given JVM will be the same 
size regardless of the objects 
they reference, but each JVM 
might have a different way of 
representing references, so 
references on one JVM may be 
smaller or larger than references 
on another JVM. 

Can I do arfthmettc on a 
reference variable, Increment It 
you know -C stuff? 

./^I Nope. Say It with me again, 
"Java is note." 




Java Bxpostdi 

This week's Interview: 
Object Reference 

HeadRrst So, telJ us, wharfs life like for an object reference? 

Reference: Pretty simple, really. Vm a remote control and I can be programmed to 
control different objects. 

HeadRrst Do you mean different objects even while you*re running? like, can you 
refer to a Dog and then five minutes later refer to a Car? 

Reference: Of course not Once Pm declared^ diat*9 it. If Vm a Dog remote control 
then Fll never be able to point (oops - my bad, we*re not supposed to say pmf}(} I mean refer 
to anything but a Dog. 

HeadRrst: Does that mean you can refer to only one Dog? 

Reference: No. I can be referring to one Dog, and then five minutes later I can refer to 
some other Dog As long as it's a Dog, I can be redirected (like rq^rogramming your remote 
to a different TV) to it. Unless,., no never mind. 

Head First: No, teU me. ^Vhat were you gonna say? 

Reference: I don*t think you want to get into diis now, but Fll just give you the shon 
version -if Tm marked as final, then once I am assigned a Dog^ I can never be repro- 
grammed to anything else but ihal one and only Dog In other words, no other object can 
be assigned to me. 

HeadFirst You*re right, we don't want to talk about diat now. OK, so unless youVe 
final, then you can refer to one Dog and then refer to a different Dog later Can you ever 
refer to rwthi/ig at all? Is it possible to not be programmed to anything? 

Reference: Yes, but it disturbs me to talk about it 

HeadRrst Why is thaL^ 

Reference: Because it means Pm nul 1, and that's upsetting to me. 
HeadFirst: You mean, because then you have no value? 

Reference: Oh, nul 1 is a value. Tm still a remote control, but it*s like you brought 
home a new undrversal remote control and you don't have a TV Fm not programmed to 
control anything They can press my buttons all day long, but nothing good happens. I 
just feel so... useless. A waste of bits. Granted, not that many bits, but still. And that*s not 
the worst part. If I am the only reference to a particular object, and then Fm set to nul 1 
(deprogrammed), it means that now nobody can get to that object I had been referring to, 

HeadRrst And that's bad because... 

Reference; You have to ask? Here I've developed a relationship widi tins object, an 
intimate connecdon, and then the de is suddenly cruelly severed. And I %vili never see 
that objea again, because now it's eligible for [producer, cue.tr^c music] garbage colkctim. 
Sniff. But do you think progranruners ever consider iha^ Snif. Why, why can*t I be a primi- 
tive? /A^?^^ bemg a referencL The responsibility, all the broken attachments... 
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i the garbage-collectible heap 



b = new Book ( ) ; 

c = new Book ( ) ; 

ire two Sook reference 
5. Create two new Book 
^Assign the Book objeas to 
t reference variables. 

/o Book objects are now living 
I heap. 

ices: 2 

:2 




Book 



d = c; 

i a new Book reference variable. 
' than creating a new, third Book 
t, assign the value of variable c to 
ied. But what does this mean? 
I saying, "Take the bits in c, make a 
"Sw of them, and stick that copy into rf." 

e and d refer to the Bame 
:t. 

c and d varlabloB hold 
different copies of the 
value. Two remotes 
igrammed to one TV. 

'erences: 3 

Objects: 2 

variable c. By now you know what 
means. The bits inside variable 
Hbe copied and that new copy fs 
Stuffed into variable c. 

Hh b and c refer to the 
ie object. 

ferences: 3 

ects: 2 





Book 



= b; 
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Life and death on the heap 



Book b = new Book ( ) ; 

Book c =: new Book ( ) ; 

Declare two Book reference variables. 
Create two new Book objects. Assign 
the Book objects to the reference 
variables. 

The two book objects are now living 
on the heap. 

Active References: 2 

Reachable Objects: 2 




Book 



b = c; 

Assign the value of variable t to variable 6. 
The bits Inside variable c are copied, and 
that new copy is stuffed Into variable h. 
Both variables hold Identical values. 

Both b and c rofor to the same 
object. Object 1 Is abandoned 
and eligible for Garbage Collec- 
tion (GC). 

Actrve Referenced: 2 

Reachable Objects:! 

Abandor\ed Objects: 1 

The first object that b referenced Object 1, 
has no more references. It's unreachable. 




Book 



c - null; 

Assign the value null to variable r 
This makes e a null reference, meaning 
it doesn't refer to anything, But it's still 
a reference variable, and another Book 
object can still be assigned to It. 

Object 2 still has an active 
reference (b), and as long 
as It does, the object is not 
eligible for GC. 

Active References: 1 

null References: 1 

Reachable Objects:! 

Abandoned Objects: 1 




Book 
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[An array is like a tray of cups 

' Declare an int array voriablc. An array variable is 

a remote control to an array object. 

int [ 1 nums ; 



primitives and references 



o 



Create a new int array wrth a length 
of 7, and assign it to the previously- 
declared intf ) variable nxmh 



nums = new int [7] ; 



Sive each element in the arrccy 
an int value. 

Remember, elements in an int 
arroy are just int variables. 



nums [0] 
nums [1] 
numfi [2] 
numd [3] 
nums [4] 
nums [5] 
nums [€] 



6; 

19; 

44; 

42; 

10; 

20; 

1; 




rays are objects too 

; Java standard library includes 
K of sophisticated data structures 
ling maps, trees, and sets 
>rt Appendix B) , but arrays are 
great when you just want a quick, 
oftlered, efficient list of things. 
Arraw give you fast random 

; by letting you use an index 
ion to get to any element in 
ay. 

Or" element in an array isjtist 
bie. In other words, one of 
;ht primitive variable types 
Large Furry Dog) or a 





reference variable. Anything you 
wouJd put in a variable of that type 
can be assigned to an array element 
of that type. So in an array of type 
int (int[]), each element can hold 
an inL In a Dog array (Dog[]) each 
element can hold... a Dog? No, 
remember that a reference variable 
just holds a reference (a remote 
control), not the object itself. So 
in a Dog array, each element can 
hold a remoU control to a Dog. Of 
course, we still have to make the 
Dog objects.,, and you'll see all that 
on the next page. 



Be sure to notice one key thing 
in the picture above - th^ array is 
an object f even though it's an array of 
primitives. 

Arrays are always objects, wbether 
they're declared to bold primitives 
or object references. But you can 

have an array object that's declared 
to ^o/^f primitive values. In other 
words, the array object can have 
elements v^hich are primitives, but 
the array itself is never ^ primitive. 
Regardless of what the array holds, 
the array itself is always an object! 
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an array of objects 



Make an array of Pogs 



beclare o Dog array variable 
Dog[] pets; 

©Crexite a new Dog Qwcr/ with 
Q length of 7, and assign it to 
the previously-declared Dog [ 
variable pets 

pets = new Dog[7] ; 



Whafs missing? 

DogslWe have an array 
of Dog references, but no 
actual Dog ob}ects\ 




Create new Dog objects, and 
assign them to the array 
elements. 

Remember, elements in a Dog 
array are just Dog reference 
variables. We still need Dogs! 

pots[0] = new Dog() ; 
petsEl] = new Dog() ; 




^rpen your pencil — 



What Is the current value of 

"^"^-^vQu^^d make 
^ne of the 
^ objects? 




58 c r3 



primitives and references 




. JWM eMe« abo»* 

(spillosi., '«>^fj°^ because « 
?he orroy's declared type* 




Control your Pog 

(with a reference variable) 

Dog fido = new Dog ( ) ; 

fido.naiae = "^Fido" ; 

We created a Dog object and 
used the dot operator on the 
reference variable yid^ to access 
the name variable.* 

We can use the fide reference 
to gel the dog to bark() or 
eat() or chaseCat(). 

fido . bark ( ) ; 

fido , chaseCat ( ) ; 

What happens if the Poq is in 
a Pog array? 

We know we can access the Dog's 
instance variables and methods using 
tiie dot operator, but on what? 

When the Dog is in an array, we don*t 
have an actual variable name (like 
fido). Instead we use array notation and 
push the remote control button (dot 
operator) on an object at a particular 
index (position) in the array: 

Dog[] myOogs = new Dog[3] ; 

inyDogs[0] = new Dog() ; 

inyDogs[0] .name = '"Fido"; 

inyDogs[0] .barJc() ; 




og 6o\ 



*Ybs we know we're not demonstrating encapsuFatjon here, bul we're 
trying to keep il simple. For now. We'll do encapsulation in chapter 4, 



Vttp are her0 



61 



using references 



class Dog { 
String name; 

public static void main (String[] args) { 

// inake a Dog object and access it 
Dog dogl = new DogO; 
dogl .barkO ; 
dogl. name = ^"Bart"; 

// now niaice a Dog array 
Dog[] myDogs - new Dog [3]; 
// and put some dogs in iz 
myDogs [0] - new Dog () ; 
myDogs [1] - new DogO; 
myDogs [2] = dogl; 

// now a<?3E?|^.s the Dogs using the array 
// references 
myDogs [0] .name = ''Fred"; 
myDogs [ 1) , name = "Marge"; 

// Hmnimn. . . what is myDogs [2] name? 
System.out. print ("last dog's name is ; 
System. out. println (myDogs [2] - name) ; 

// now loop through the array 
// .vu'ici Cell all dogs to bark 
int X = 0; 

while (x < myDogs. length) { ^ ^ 

myDogs [x] .bark { ) ; >/av^VaW€ '^^"^r 



A Pog example 



public void bark() { 

System, out .println (name f says Ruffl"); 

} 

publ ic void eat () { } 
public void cjiaseCat() { ) 




Output 



%java Dog 

null says Ruff! 

last dog's name is Bart 

Fred says Ruff! 

Marge says Ruff! 

Bart says Ruff! 



-BuiLET ponin 

Variables come in two flavors: primitive and 
refefence. 

Variables must always be declared with a name 
and a type. 

A primitive variable value is the bits representing 
the value (5, "a', true, 3.1416, etc.). 
A reference variable value is the bits 
representing a way to get to an object on the 
heap. 

A reference variable is like a remote control. 
Using the dot operator (.) on a reference 
variable is like pressing a button on the remote 
control to access a method or instance variable. 
Areference variable has a value of null when 
it is not referencing any object. 
An an^y is always an object, even if the'afray 
is declared to hold primitives. There is no such 
thing as a primitive aray, only an array that 
holds primitives. 
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Each of flie Java files on fliis page 
represents a coinplete Source file. 
Your job is to play compiler and 
deterinine wlielier eacK of lliese files 
will compile . If Aey won*{ 
jjj^ compile, horn would you 
fixfliem? 



class Books { 
String title; 
String author; 

} 

class BooksTestDrive { 
public static void main (String [] arga) { 

Books [] myBooks = new Sooks[3); 
int X = 0; 

myBooks [0]. title ^'The Grapes of Java"; 
myBook3[ 1] -title = ^The Java Gatsby"; 
mySook3[2] .title = "The Java Cookbook"; 
mySooksfO] .author = "bob"; 
myBooks (1). author - "sue"; 
inyBook3[2) .author = "ian"; 

while (X < 3) { 

System. out. print(my8ooks[x) .title) ; 
System. out. print (" by 
System ► out . println { myBooks ( x ] . author ) ; 
X = X + 1; 

) 



class Bobbits { 
String name; 

public static void main{String [] args) { 

Hobbits [] h = new Hobbits[3]; 
int 2=0; 

while (2 < 4) { 
z = 2 + 1; 

h(2) = new HobbitsO; 
h{2] .name = "bilbo"; 
if (2 1} { 
h[2] .name = "frodo"; 

> 

if (2 == 2) { 

h[2).naine = *'3am"; 

} 

System-out.print (h[2) -name + " is a "); 
System.out. println ("good Hobbit name"); 
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Code Magnets 

A working Java program Is all scrambled up 
on the fridge. Can you reconstruct the code 
snippets to make a working Java program 
that produces the output listed below? 
Some of the curly braces fell on the floor 
and they were too small to pick up, so feel 
free to add as many of those as you need! 



'I java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 




Sys tem. out. print In (is lands [ref] ) ; 




String [] islands = new String[4]; 



System, out, printif "island = 




I 



class TestArrays { 



Public static void main(String 



[] args) { 
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P^I puzz]e 




Your Job is to take code snippets from 
the pool and place them into the 
blank lines in the code. You may 
use the same snippet more than 
once, and you won't need to use 
all the snippets. Your goal is to 
nr*ake a class that will compile and 
run and produce the output listed. 



Output 



1 File Edtt VN^ndow Help 


Bamnuds 


— 1 


%java Triangle 






triangle 0, area 


= 4.0 




triangle 1 , area 


= 10.0 




triangle 2, area 


= 18,0 




triangle 3, area 


= 




V = 













Bonus QuestionI 

For extra bonus points, use snippets 
from the pool to fill in the missing 
output (above). 



class Triangle { 
double sirea; 
int height:? 
int length; 
public static void inain(String [] args) { 



■ate 



while ( 



) { 



.height = (x + 1) * 2? 
•length = x + 4; 



System, out. print ("triangle ''+x+"y area"); 
Sy stem, out •println{*' - " + .area); 



X = 27; 

Triangle t5 = ta[21; 

ta[2 ) -area = 343; 

Sys tern* out .print (^y = + y); 

System. out *println(*, t5 area - 



"+ tS.area) ; 



> 

void setArea( ) { 



(height * length) / 2; 



area 
ta.area 

ta(xl.area 



4, t5area=* 18,0 
4, t5 area = 343.0 
27; tS area = 18,0 
27,t5 area = 343.0 



Triangle [ ] ta = newTrlangle(4); 
Triangle ta = new ( ] Triangle[4); 
Jnangle [ ) ta = newTriajfteK); 



ta(x] = setAreaO; 
tajt = setAreaO; 
tatx).setArea(); 



Note: Each inlppet 
from the pool can be 
used more than oncel 



int x; 
Int y; 
int x = 0; 
lntx= 1; 
int y = x; 

28.0 
30.0 



X = X + 1 ; 
X = X + 2; 
X = x -1; 



taj( 
ta(x) 
ta[x] 



ta = newTriangleO; 
ta[x] = newTrlangleO; 
ta.x = new TriangleO; 



x<4 
x<5 
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puzzle: Heap o' Trouble 




A Heap o' Ti»oiibIe 

A short Java program is listed to the 
right. When V/ do stuff' is reached, some 
objects and some reference variables 
will have been created. Your task Is 
to determine which of the reference 
variables refer to which objects. Not all 
the reference variables will be used,and 
some objects might be referred to more 
than once. Draw lines connecting the 
reference variables with their matching 
objects. 

Tip: Unless you're way smarter than us, 
you probably need to draw diagrams 
like the ones on page 55 and 56 of this 
chapter. Use a pencil so you can draw 
and then erase reference links (the 
arrows going from a reference remote 
control to an object). 



class HeapQuiz { 
int id ^ 0; 

public static void main (String [] args) { 
int X = 0; 

HeapQuiz [ ] hq = new HeapQuiz[5]; 
while ( X < 3 ) ( 

hq[x] = new HeapQuiz (); 

hq[x] , id ^ x; 



X = 


X 


+ 1; 


) 

hq[3] 




hq[l] ; 


hq[4] 




hq[l] ; 


hq[31 




null; 


hq[4] 




hq[0]; 


hq[0] 




hq(3]; 


hq[3] 




hq[2] ; 


hq[2] 




hq[0]; 


// do 


stuff 



Reference Variables: 



CO 



2 



hq[0] 



I 

N12] 

hq[4] 



hq[3] 



HeapQuiz Objects: 

C0 
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Mystery 



The case of the pDfered references 

It was a dait and stormy night Tawny strolled into theprogrammeis' bullpen like slie 
owned the place. She knew diat all the programmers would still be hard at work, and she 
wanted help. She needed a new method added to the pivotal class that was to be loaded into the 
client's new top-secret Java-enabled cell phone. Heap space in the cell phone's memory was 
as tight as Tawny*s top, and everyone knew it The normally raucous buzz in the buUpen fell to 
silence as Tawny eased her way to the white board She sketched a quick overview of the new 
metiiod's functionality and slowly scanned the room, 'WeU boys, it's crunch time", she purred. 
'Whoever creates the most memoiy efBcient version of this mediod is coming with me to the 
client's launch p^rty on Maui tomorrow... to help me install the new software/* 

The next moming Tawny gbded into the bullpen wearing ber short Aloha dress. 
''Gentlemen", she smiled, "the plane leaves in a few hours, show me what youVe 
gotl". Bob went first; as he began to sketch his design on the white board Tawny 
said, "Let's get to the point Bob, show me how you handled updating the list of con- 
tact objects.'* Bob quickly drew a code fragment on the board: 



Contact [) ca = new Contact (10 J; 

while ( X < 10 ) { // maJce 10 contact objects 

cafx) = new ContactO; 

X = X + 1; 

) 

// do complicated Contact list updating stuff with ca 



'Tawny I know we're tight on memory, but your spec said that we had to be able to access 
individual contact information for all ten allowable contacts, this was the best scheme I could 
cook up'\ said Bob. Kent was next, already imagining coconut cocktails with Tawny, "Bob," 
be said, '*your solutionis a bit kludgy don't you think?" Kent smirked, 'Take a look at this 
bab/': 

Contact refc; 

while ( X < 10 ) { // makie 10 contact objects 
refc = new ContactO; 
X = X + 1; 

} 

// do complicated Contact list updating stuff with refc 

"I saved a bunch of reference variables worth of memory, Bol>o-rino, so put away your 
sunscreen", mocked Kent '"Not so fast Kent!", said Tawny, '"yonWe saved a htUe memory, but 
Bob^s coming with me.". 



Why did Tiwny choose Boys method over Kent% when Kent's used less memory? 
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Exercise Solufions 



Code Magnets: 



class TestArrays { 

public static void main (String [] args) { 
int [] index = new int(4]; 
indeK[0] = 1; 
index[l] = 3; 
index[2] = 0; 
index[3] = 2j 

String (] islands - new String[4J; 
islands [0] = "Bermuda"; 
islands! 1] = '"Fiji"; 
i3lands(2] = "Azores"; 
island3f3] = "Cozumel"; 
int y = 0; 
int ref; 
while (y < 4) < 
ref = index[y] ; 

System, out .print ( "island = ")? 
System^out .println ( islands [ ref ] ) ; 
y - y + 1; 

> 



Re 6dll mn^ Help Btiv 



\ java TestArrays 
island = Fiji 
island = Cozumel 
island = Bermuda 
island = Azores 



class Books { 
String title; 
String author; 

\ 

class BooksTestDrive ( 

public static void [nain( String [] args) { 
Books [J myBooks - new BooksfSJ; 
int X = 0; 
^ mySooks[0] = new SooksQ 
my6ool<s[l] = new BooksQ 
my6ooks[2] ' new BooksQ 



ftemember: We have to 
actuaify make the Books 
objects I 



myBookstO] -title = "The Grapes of Java"; 
myBook8(l] .title = "The Java Gatsby"; 
niyB0Qkg(2] .title = ^'The Java Cookbook'; 
myBooksfO] .author = "bob"; 
myBookal 1] .author = "sue"; 
cnyBooks ( 2 ]. author = "ian*; 
while (X < 3) { 

Sy stem ► out < print (my Books (X). title ) ; 

Sy stem. out- print (" by "); 

System, out, println (my Bookslx] » author) ; 



x + 1; 



class Hobbits { 
String name; 

public static void main(String [] args) { 
Hobbits [ I h = netf HQbbits(3); 
■1; 



Rerrember: onroys stort with 
element 0 ) 



B 



int 2 

while iz<2)[ 
2 = 2 + 1; 
h[z] ' new Bobbits( ) ; 
h(z] .name = "bilbo"; 
if (2 == 1) { 

h[2] .name = "frodo"; 

} 

if {Z == 2) { 
h[2j .name = "sam"; 

) 

Sy stem.out.pr int (h| z) .name + is a 
System. out. println( "good Hobbit name"); 
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puzzle Solutions 



claas Triangle { 
double axea; 
int height; 
Int length! 

public static void main (String [] arga ) { 
Int X = 0; 

Triorylc [ ] ta = nfcw TriongleW; 

while ( X < 4 ) { 
tuM = />cw THongleO' 
talx]. height « (x + 1) * 2? 
tofx]. lengt-h = x + 4; 
ta(x].$etAneaO; 

System^out. print triangle area") j 

Syatem.out.printlnC' * " + tiitx],area) ; 
X = X ♦ 1; 

> 

fnt y = x: 

X - 27; 

Triangle tS ta[2l; 
tft[2] .area = 343; 
Syatem. oat, print ( = " + y); 
System* out. println ( t5 axea 

> 

void aetArea( ) { 

Qr«a = (height • length) / 2; 



tS.area); 



1 FAm ^ija Window H*to B»nx<a* 


i java Triangle 




triangle 0, area = 


4.0 


triangle 1 , area = 


10. 0 


triangle 2. area = 


la.o 


triangle 3, area = 


28.0 


y = 4, t5 area = 343 





The case of the pilfered references 

Tawny could see that Rent's method had a serious 
flaw. It's true that he didn*t use many reference 
variables as Bob, but there was no way to access any 
but the last of the Contact objects that his method cre- 
ated. Wth each trip through the loop, he was assign- 
ing a new object to the one reference variable, so the 
previously referenced object was abandoned on the 
heap - unreachable. Without access to nine of the ten 
objects created, Kent*s method was useless. 

(The software was a huge succaas and the dieni gave Tawny and Bob an antra week 
h Hawad. Wa'd like to tefl you that by finishing (his book you loo wil gel stuff Ifke that) 



Reference Variables: 



HeapQulz Objects^ 
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4 methods use Instance variables 



How Objects Behave 




State affects behavior, behavior affects state, we know that objects 

have state and behavior represented by Instance variables and methods. But until now, we 
haven't looked at how state and behav^o^ are re/ated.We already know that each instance of a 
class (each object of a particular type) can have its own unique values for its instance variables. 
Dog A can have a /iame"Fido''and a weight of 70 pounds. Dog 8 is''Killer''and weighs 9 pounds. 
And If the Dog class has a method makeNoiseO/Well, don't you thinka 70-pound dog barks a 
bit deeper than the little 9-pounder? (Assunrking that annoying yippy sound can be considered 
a bark.) Fortunately, thaVs the whole point of an object— it has behavior that acts on its sf^fe. In 
other words, methods use tnstanc^ variable vaiuei. Like/if dog Is less than 14 pounds, make 
yippy sound, else..." or "increase weight by S^t Lefsgo change some state. 



this is a new chapter 
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objects have state and behavior 



Remember: a class describes what ah 
object khows and what an object does 



A class is the blueprint for an object When you 
write a class, you're describing how the JVM 
should maJce an object of that type. You aheady 
know that every object of that type can have 
different instance variable y^nes. But what about 
the methods? 

Can every object of that type have different 
method behavior? 

Wt\l..sartqf* 

Every instance of a particular class has the same 
methods, but the methods can behave djfEerendy 
based on the value of the instance variables. 

The Song class has two instance variables, tide 
and ariisL The playO method plays a song, but 
the instance you call playO on will play the song 
represented by the value of the title instmce 
variable for that instance, So» if you call the playO 
mediod on one instance you'll hear the song 
"Politik", while another instance plays "Darkstar". 
The method code, however, is the same. 

void playO { 

soundPlayer.playSound(title) ; 

} 



Instance 
variables 

(state) 

methods 

(behavior) 



title 
artist 




satntleO 

sfitArtistO 

playO 




Song t2 = new SongO; 
t2,3etArtist(^Travis") ; 
t2 . setTitle ("Sing") ; 
Song s3 = new Song(); 
fl3.setArtJ.st(^^Sex Pistols"); 
s3.aetTitLLe("My Way"); 




Song 
t2.play() ; 



Song 
S3. play 0 ; 

will ^uic "/Wy Wiy" -to play. 



•Yes. another siunninQly clear answerl 
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methods use instance variables 



Iht size affects the bark 



h Dog's bark is different from a big Dog s bark. 

: Dog class has an instance variable size, that the 
^ method uses to decide what kind of bark sound 



5s Dog { 
it size; 
tring name; 

7id barkO { 
if (size > 60) ( 

System- out. println ("Wooof ! Wooof ! ") ; 
) else if (size > 14) { 

System. out. println{^^Ruff! Ruff!") ; 
) else f 

System. out. println ("Yip! Yip!") ; 

\ 




ass DogTestDrive ( 

Ijpublic static void main (String!) args) f 
Dog one = new DogO; 
one-size ^ 70; 
Dog two = new Dog ( ) ; 
two. size = 8; 
Dog three = new Dog () ; 
three-Size = 35; 



one.bark 0 ; 
two .bark () / 
three-barkO ; 



I F\\& Edit Window Help Plavde^d 



%java DogTestDrive 



Wooof? Wooof > 
Yipf Yip! 
Ruff! Ruff> . 




you are here t 



73 



method parameters 



You can send things to a method 

Just as you expect from any programming language, you can pass values into 
your methods. You might, for example, want to tell a Dog object how many 
times to bark by calling: 

d.barlc(3) ; 

Depending on your programming background and personal preferences. 
you might use the term arguments or perhaps p€trametm for the values passed 
into a method. Although there are formal computer science distinctions that 
people who wear lab coats and who will almost certainly not read this book, 
make» we have bigger fish to fry in this book. So ycv. can call them whatever 
you like (arguments, donuts, hairballs, etc.) but we're doing it Uke this: 

A method uses parameters. A caller passe s arguments. 

Arguments are the things you pass into the methods. An argument (a value 
like 2, "Foo", or a reference to a Dog) lands facedown into a.„ wait for it.. 
parameter. And a parameter is nothing more than a local variable. A variable 
with a type and a name, that can be used inside the body of the method 

But here*s the important part: If a method takes a parameter, you must pass 
it something. And that something must be a value of the appropriate type. 



Call the bark method on the Dog refer 
ence, and pass in the value 3 (as the 
argument to the method). 



Dog d = new Dog ( ) ; 
bark (3) ; 




The bits representing the int 
value 3 are delivered into the 
bark method. 



void bark (int numOrBarks) 



©The bits land in the numOf Barks 
I 



parameter {an int-sized variable). 



{ 



while (numOfBarks > 0) { 

System, out . println (^'ruf f ") ; 
numOfBarks = nxomOfBarks - 1; 

} 



OUse the numOfBarks 
parameter as a variable in 
the method code. 
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methods use instance variables 



You eaH get things baekfro^vi a method. 

Ifcdtods can return values. Every method is declared with a return 
j wpc. hm until now weVe made all of om- methods with a void 
•Hum VfpQ, which means they don't give anything back. 

r«oid go() { 



[i^'e can declare a method to give a specific type of value 
. to the caDer, such as: 

giveSecretO { 

return 42; 



I declare a method to return a value, you must 
I a value of the declared type! (Or a value 
t is ampatibl£m\h the declared type. We'll get 
► ihai more when we talk about polymorphism 
idtapter 7 and chapter 8.) 



Whatever you say 
youHl give back, you 
tetter give back! 




int theSecret = life.giveSecret() ; 



1- a»-e v-ct**"*^- 
int giveSec^etO { ^^^^^^^I'J^^^^^^^ 



return (42^ 

must ^ it 
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multiple arguments 

You can send more than one thing 
to a method 

Methods can have multiple parameters. Separate them 
with commas when you declare them, and separate the 
arguments with commas when you pass them. Most 
importandy, if a method has parameters, you must pass 
arguments of the right type and order 

Calling a two-parameter m^ihod, and sending 
it two arguments. 

void go() { 

TestStiiff t = new TestStuff(); 
t.takeTwo(12, 34); j^^ 

void takeTwo(lnt x, int y) ( 
int z = X + y; 

System. out. printlA<^^ Total is " + z) ; 

) 



You eaH pass varlabUs Into a method, as long as 
the variable type matches the parameter type. 

void goo ( .C^a^^^'^'lA*^" 



t.takeTwo(foo, bar); 



int foo = 7; V^t ^^'^^^^M^. . 

int bar = 3; 




void ta]caTMo(iat x, int y) ( 
int z " X + y; 

System. out. println ("Total is " + z) ; at -t)^ 



) 



, C ^? It's tV»c i^*"' 
Var at tM ^ >^ 
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methods use instance variables 



Java is pass-by-vajue. 
That means pass-by-copy. 



int X = 7; 





Oeclore an int vo^roBleand assign it 
the value The bit pattern for 7 
goes into the variable named 



d go (int z) { } 



int 



declare a method with an int 



parameter named 





int 

foo.go (x) ; 



Call the goQ method, passing 



the variable x as the argument. 
The bits in x are copied, and 
the copy lands in 2. 



int 



void go (int z) { } 




^ o 



int 

void go (int z) { 
2 = 0; 

} 



Change the value of z inside 
the method. The value of x 
doesn't change! The argument 
passed to the z parameter was 
only a copy of x. 

The method can't change the 
bits that were in the colling 
variable x. 
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arguments and return values 



What happens If the argument you want to 
pass an object Instead of a primitive? 



A: 



'You'll learn more about this in later chapters^ 
but you already /rnow the answer Java passes 
everything by value, fverything. But... value means 
bits inside the variable^ And remember, you don't 
stuff objects Into variables; the variable Is a remote 
control — a reference to an object. So if you pass a 
reference to an object into a method, you're passing 
a copy of the remote control. Stay tuned, though, we'il 
have lots more to say about this. 

a method declare multiple return values? 
Or Is there some way to return more than one 
value? 



A: 



L* Sort of. A method can declare only one return 
value. BUT.,. If you want to return, say, three int values, 
then the declared return type can be an int array. 
Stuff those Ints into the array, and pass it on back. It's 
a little more involved to return multiple values with 
different types; we'll be talking about that in a later 
chapter when we talk about ArrayLlst. 



A, 



Do I have to return the exact type I declared? 



L-You can return anything that can be implicitly 
promoted to that type. So, you can pass a byte where 
an Int Is expected. The caller won't care, because the 
byte fits Just fine into the Int the caller will use for 
assigning the resuh.You must use an explicit cast 
when the declared type issm^j/Zerthan what you're 
trying to return. 

Do I hav» to do something with the return 
value of a method? Can I Just Ignore K7 

-^V' doesn't require you to acknowledge a 
return value. You might want to call a method with 
a non-void return type, even though you don't care 
about the return value. In this case, you're calling 
the method for the work it does /ns/de the method, 
rather than for what the method gives returns. In 
Java, you don't have to assign or use the return value. 




Reminder: Java 
cares about type! 

You can't return a Giraffe when 
the return type Is declared 
as a Rabbit. Same thing with 
paranneters. You can't pass a 
Giraffe into a method that 
takes a Rabbit. 



BULLET POINfS 



Classes define v/hat an object knows and what an 
object does. 

Tilings an object knows are its instance variables 

(state). 

Things an object does are its methods (behavior). 

Methods can use instance variables so friat objects 
of the same type can behave differently. 

A method can have parameters, which means you 
can pass one or more values in to the method. 

The number and type of values you pass in nnust 
match the order and type of the parameters 
declared by the method. 

Values passed in and out of methods can be 
implicitly promoted to a larger type or explicitly cast 
to a smaller type. 

The value you pass as an argument to a method 
can be a literal value {2, 'c\ etc.) or a variable of 
the declared parameter type (for example, x where 
X is an int variable). (There are other things you 
can pass as arguments, but weVe not there yet.) 

A method must declare a return type. A void return 
type means the method doesn't return anything. 

If a method declares a non-void return type, it must 
return a value compatible with the declared retum 
type. 
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methods use instance variables 



things you can do with parameters 
return types 

tfaai we've seen how parameters and return types work, it's 
► pmi them to good use: Getters and Setters. If youVe into 
lonnal about it, you might prefer to call them Acce^on 

. But that's a waste of perfecdy good syllables. 
Ge-tters and Setters fits the Java naming convention, so 
L we'll call them. 

a^nd Setters let you, well> and set things. Instance vari- 
usually. A Getter's sole purpose in life is to send back, 
value, the value of whatever it is that particular Geaer 
. lo be Getting. And by now, if s probably no surprise 
ScGcr Uves and breathes for the chance to take an argu- 
aJ^je and use it to the value of an instance variable. 



MS ElftctxicGuitar { 

St^iag brand; 

nufflOfPickups ; 
boolean rockStaxUsealt; 

St-ring getBrandO { 
return brand; 



EtectricGuftar 



brand 

numOfPickups 
rockStarUsesIt 



getflrandQ 
setBrandO 

getNumOfPickupsO 
setNumOfPickupsQ 

gelRockStarUsesltO 
satRockStarUsesltO 




"poid satBrand (String aBrand) { 
brand = aBrand; 

I 

getNuzaOf Pickups 0 { 
return n\iroOf Pickups; 

I 

wad satNumOfPickups (int num) { 
DaxnOfPic]cupa = num; 



e&n gatRockStArasaalt 0 { 
return rockStarOsesIt ; 




setRockStarUaealt (boolean yesOrNo) ( 
rocks tarUses It = yesOrNo; 
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real developers encapsulate 



EhcapsulatioH 

Po it or risk humtliatioH and 
ridicule. 

Und) this most important moment, weVe 
been committing one of the worst OO 
faux pa5 (and we're not talking minor 
violation Hke showing up without the 'B' 
in BYOB). No, we're talking Faux Pas with 
a capital T. And *P'. 

Our shameful transgression? 

Exposing our daial 

Here we are, just humming along without 
a care in die world leaving our data out 
diere for anyone to see and even touch. 

You may have already experienced that 
vaguely unseeding feeling that comes with 
leaving your instance variables exposed. 

Exposed means reachable with the dot 
operator, as in: 

theCat, height = 27; 

.Think about this idea of using our remote 
control to make a direct change to the Cat 
object's size instance variable. In the hands 
of the wrong person, a reference variable 
(remote control) js quite a dangerotis 
weapon. Because what's to prevent: 




theCat. height = 0; 



This would be a Bad Thing, We need to 
build setter methods for all the instance 
variables, and find a way to force other 
code to call the setters rather than access 
the data direcdy. 



public void setHeight (int ht) { 
if (ht > { y 

height = ht; > 

} 

> 



1 • - ■■' ^h^cks 



80 chapter 4 



methods use instance variables 



i M the data 

t k is that simple to go from 
aplcmentation that's just 

ig for bad data to one 
E protects your data and 

J your right to modify 
' implementation later. 

, so how exactly do you 
f die data? With the 
Lie and private 
; modifiers. You're 
iliar with public-we use 
1 every main method. 

t's an encapsulation 
Tule of thumb {all stan- 
l disclaimers about rules 
lb are in effect): mark 
fmmr instance variables private 
I provide pubhc getters 
[setters for access control 
I TOU have more design 
t coding savvy in Java, you 
My do things a little 
cntly, but for now, this 
ach will keep you ^e. 



Mark instance 
fables prfva 



irk getters aind 
setters publle. 



1 

1 



*Sadly. Bill forgot to 

capsulate his Cot class and 
tended up with a flat cat." 

lovertieard at the water cooler). 




Java EAqposeJ: 



This week's Interview: 

An Object gets candid about encapsulation. 

HeadRrst What's the big deal about encapsulation? 

Object: OK, you know that dream where you're giving a talk to 500 popple when you 
suddenly realize- you're Tiaked? 

HeadFirst Yeah, we've had that one, Ii*s right up there with the one about the Pilates 
madiine and,,, no, we won't go there. OK, so you feel naked. But odaer than being a litde 
exposed, is there any danger? 

Object Is there any danger? Is there any danger? [starts laughing] Hey, did all you other 
instances hear that, ''Is there any danger?'' he asks? [falls on the floor laughing) 

HeadRrst What's funny about that? Seeois like a reasonable question. 

Object OK, TQ explain it. It's [bursts out laughing again, uncontrollably] 

HeadFirst Can I get you anything? Water? 

Object Whew! Oh boy. No I'm fine, really TU be serious. Deep breath. OK, go on. 
HeadRrst So what does encapsulation protect you from? 

Object Encapsulation puts a force-field around my instance variables, so nobody can set 
them to, let's say, somediing inapfnofmak. 

HeadRrst Can you give me an example? 

Object Doesn't take a PhD here. Most instance variable values aie coded with certain 
assumptions about the boundaries of the values. like, think of all the things that would 
break if negative numbers were allowed Number of bathroonis in an office- Velodty of 
an airplane. Birthdays, Barbell we^t Cell phone ntunbers. Microwave oven power: 

HeadRrst I see what you mean. So how does encapsulation let you set boundaries? 

Object By forcing other code to go throi^ sener mediods. That way, the sener mediod 
can validate the parameter and decide if it's do-able. Maybe die method will rejea it and 
do notMng, or maybe it^li throw an Exception ^e if it's a null sodal security number 
for a credit card application), or maybe the method will round the parameter sent in to 
the nearest acceptable value. The point is, you can do whatever you want in the setter 
method^ whereas you can*t do cmything if your instance variables are public. 

HeadFirst But sometimes I see sener methods that simply set the value without check- 
ing anything If you have an instance variable that doesn't have a boundary, doesn't that 
sener method create unnecessary overhead? A performance hit^ 

Object The point to setters (and getters, too) is that_>pow can change ycntr tnmd later, 
■withcmt breaking anybody else^s Imagine if half the people in your com- 
pany used your class widi public instance variables, and one day you suddenly realized, 
"Oops- there's something I didn't plan for with that value, Tm going to have to switch to a 
sener method." You break everyone's code- The cool thing about encapsulation is ihatjuw/ 
get to chmgeyotcr mind. And nobody gets hurt The performance gain from using variables 
direcdy is so nuniscule and would rarely — if euei — be w^rth 11 
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how objects behave 



Encapsulating the 
^oodPog class 



class GoodDog { 

private int size; 



public int gecSizeO { 



return size; 



public void setSize(int s) { 
size = s; 

) 




^tr, 




ly place where a 
fcieular value can' 
used, a method 
call that returns that 



void barko { 

if (size > 60) { 

Syscem.out.pirintln (""Wooof ! Wooof ! ") 
) else if (size > 14) { 

Syscem.out.println (""Ruf f ! Ruff ! ") ; 
] else { 

Syscem.out.println ('"Yip ! Yipi ") ; 

} 




class GoodDogTestDrive { 

public static void main (Stringtl args) { 
GoodDog one = new GoodDog (); 
one . setSize (10) ; 
GoodDog two = new GoodDog (); 
two. setSize (8) ; 

System. out .println ('*Dog one: + one . getSize ( ) ) ; 
System. out ,println C'Dog two: + two . getSize ( ) ) ; 
one . bark ( ) ; 
two. bark 0 ; 
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How do objects ih an array 
^have? 



methods use instance variables 



pSkc any other object. The only difference is 
ryou get to them. In other words, how you get 

^.remote control. Let s try calling methods on 
; objects in an airay. 



Declare and create a Dog array 
to hold 7 Dog references. 



Dog[] pets; 
pets = new Dog[7]; 




bog[] 



Dog array object (Dog[]) 



Create two new Dog objects, 
and assign them to the first 
two array elements. 

pets[0] - new Dog(); 
pets[l] = new Dog(); 



Call methods on the two Dog 
objects. 



pets [0] . setSize (30) ; 
int X = pet0[O] .getSize() ; 
pets[l] .aetSize(8) ; 




Dog[3 



Dog array object (bog[l) 
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initiailzing instance variables 



Instance variables 
always get a 
default value. If 
you don't explicitly 
assign a value 
to an instance 
variable, or you 
don't call a setter 
method, the 
instance variable 
still has a value! 
integers 0 
floating points 0.0 
booleans faise 
references null 



Peclariiig and fnitializing 
instance variables 

You already know that a variable declaration needs at lea^t a name 
and a type: 

int size; 
String naioe; 

And you know that you can initialize (assign a value) to the 
variable at the same time: 

int size = 420; 
String name = '"Donny" ; 

But when you don't initialize an instance variable, what happens 
when you call a getter method? In other words, what is the valtieoi 
an instance variable heforeyoxx initialize it? 



class PoorDog { 

private int size; '^'^'^^^^ 
private String name;^ 



i ■ c^-^ntC v/a>riaWc«> 



public int getSize() — ^ 
return size; X 

) / 

public String getNamaO { 
return name; 

) 



WV^at will ^c^t rrtu>rt^?? 



} 



public class PoorDogTestDrive ( 

public static void main (String [1 arga) 
PoorDog one = new PoorDog (); 
System, out .println ( ''Dog size is 
System. out,println( ''Dog name is 



} 



} 



R(6 Edit WIikJow Help Cairvei 



1 



% java PoorDogTestDrive 
Dog size is 0 
Dog name is null 



+ one.getSizeO 
+ one.gotNameO 



You don 



,ic iOT^^°^ ^^^^ 
A 
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The difference between instance 
nd local variables 



methods use instance variables 



Instance variables are declared 
ingide a class but not within q method. 

class Horse { 

private double height = 15.2; 
private String breed; 
/ / more code . . . 



Local variables are declared within gjnethod . 

class AddThing { 
int a; 
int b = 12; 

public int addO { 
int total = a + b; 
return total; 

} 



Local variables MU5T be initial(2ed before usel 



class Foo { 

public void go ( ) { 
int X; 

int z = X + 3; 



} 



} 



use >t) 



I F116 £dl\ window yikfl^ 



Local variables do 
NOT get a default 
value! The compiler 
complains if you 
try to use a local 
variable before^ 
the variable is 
initialized. 



What about method parameters? 
How do the rules about local variables 
apply to them? 



A: 



Method parameters are virtually the 
same as local variables— they're declared 
inside the method (well, technically they're 
declared In the argument list of the method 
rather than within the body of the method, 
but they're still local variables as opposed to 
instance variables). But method parameters 
will never be uninitialized, so you'll never get 
a compiler error telling you that a parameter 
variable might not have been initialized. 

But that's because the compiler will give 
you an error if you try to invoke a method 
without sending arguments that the method 
needs. So parameters are ALWAYS initialized, 
because the compiler guarantees that 
methods are always called with arguments 
that match the parameters declared for the 
method and the arguments are assigned 
(automatically) to the parameters. 



% javac Foo . java 

Foo.java:4: variable x might 
not have been initialized 

int 2 = X + 3; 
1 error 
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object equality 



Comparihg variables (primitives or references) 



Sometimes you want to know if two primitives are the same. That's easy 
enough Just use the — operator Sometimes you want to know if two 
reference variables refer to a single object on the heap. Easy as well, jMSt use 
the =- operator. But sometimes you want to know if two otjscis are equal. 
And for that, you need the . equals () method. The idea of equality for 
objects depends on the type of object. For example, if two different String 
objects have the same characters (say» "expeditious") > they are meaningfully 
equivalent, regardless of whether they are two distinct objects on the heap. 
But what about a Dog? Do you want to treat two Dogs as being equal if they 
happen to have the same size and weight? Probably not. So whether two 
different objects should be treated as equal depends on what makes sense for 
that particular object type. We'll explore the notion of object equality again 
in later chapters (and appendix B), but for now, we need to understand that 
the == operator is used only to compare the bits in two variables. What those 
bits represent doesn*t matter. The bits are either the same> or they're not. 

To compare two primitives, use the == operator 

The = operator can be used to compare two variables of any kind, and it 
simply compares the bits. 

if (a = b) {-..} looks at the bits in a and b and returns true if the bit pattern 
is the same (although it doesn't care about the size of the variable^ so all the 



Use == to compare 
two primitives, 
or to see if two 
references refer to 
the same object. 

Use the equais() 
method to see 
if two diffBrent 
objects are equal. 

(Such as two different 
String objects that both 
represent the characters 
in "Fred'^ 



extra zeroes on the left end don't matter) 
int a = 3; 
byt^e b = 3; 

if (a == b) { // true } 



byte 



To see If two references are the same (which means they 
refer to the same object on the heap) use the == operator 

Remember, the == operator cares only about the pattern of bits in the 
variable. The rules are the same whether die variable is a reference or 
primitive. So the == operator returns true if two reference variables refer to 
the same object! In that case, we don't know what the bit pattern is (because 
it*s dependent on the JVM, and hidden from us) but we do know that whatever 
it looks like, it will be the same for two refermces to a singU object 



Foo a 
Foo b 
Foo c 
if (a 
if (a 
if (b 



= new 
= new 

= a; 
== b) 
== a) 
c) 



Foo() 
Foo() 



// 
// 
// 



false ) 
true } 
false } 



a — b is -f ali« 




fbo 
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methods use instance variables 



I always 
keep my variables 



f private. If you want to 
^ see them, you have to 
I talk to my methods. 




rpen your pencil 



Mi* ^ 

passing by value 
Ts passing by copy^ 




What^s legal? 

Given the method below, which 
of the method colls listed on the 
right ore legol? 

Put a checkmark next to the 
ones that ore legol. (Some 
statements are there to assign 
values used in the method colls). 



int calcArea<int height, int width) ( 
return height * width; 

} 



int A - CAlcArea(7, 12) ; 

short c = 7 ; 

calcArea (c , 15) ; 

int d = calcArea(57) ; 

calcArda (2,3) ; 

long t = 42; 

int f = calcArea(t,17) ; 

int g = calcAreaO; 

calcArea ( ) ; 

byte h = calcArea(4,20) ; 
int j = cAlcAr6A(2,3,5) ; 
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exercise: Be the Compiler 




Each of ilie Java files on to pa^c 
represents a comply source file. 
Yoxir job is to play conipiler and 
detcrmtne >^edier each of these files 
will commie. If they won't 
eotnpile, how woald yon 
fix tiiem, and if tiiey do 
compile, >^4>af: would Be 
tiieir ou^^ 




A 

class XCopy { 
public static void inain(Strinq [) args) { 
int orig = 42; 
XCopy X = new xCopyO; 
int y = x.go(orig) ; 
System. out. println( orig + " + y) ; 

} 

int go (int arg) { 
arg = arg * 2; 
return arg; 

> 

} 



B 

class Clock { 
String time; 

void setTime( String t) { 
time = t; 

} 

void getTimeO { 
return time; 

} 

} 

class ClockTestDrive { 

public static void main(String [] args) { 

Clock c = new Clock( ) ; 

c,setTimeC1245''); 
String tod = c.getTime(}; 
Systein.out. print In {''time: " + tod); 



88 chapter 4 



methods use instance variables 



A bunch of Java components, in full costume, are playing a party 
game/Who am I?" They give you a clue, and you try to guess who 
they are, based on what they say. Assume they always tell the truth 
about themselves. If they happen to say sonnething that could be true 
for more than one guy, then write down all for whom that sentence 
applies. Fill in the blanks next to the sentence with the names of one 
or more attendees. 

Tonlghfs attendees: 

Instance variable/ argument return/ getter, setter, 
encapsulation, public; private/ pass by value/ method 



A class can have any number of these, 

A method can have only one of these. 

This can be implicitly promoted. 

I prefer my Instance variables private. 

It really means 'make a copy'. 

Only setters should update these. 

A method can have many of these. 

I return something by definition. 

I shouldn't be used with instance variables. 

I can have many arguments. 

By definition, I take one argument 

These help create encapsulation. 

I alv^ays fly solo. 
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puzzle: Mixed Messages 



Mixed 



A short Java program is listed to your right. 
Two blocks of the program are mlsslr^g. 
Your challenge Is to match th« candidate 
blocks of code (below), with the output 

that you'd see if the blocks were Inserted. 

Not all the lines of output will be used, and 
Sonne of the lines of output might be used 
more than once. Draw lines connecting 
the candidate blocks of code with their 
matching command-line output. 



CandldAtes: 



Possible output: 




public class Mix4 { 
int counter = 0; 

public static void main (String [] args) { 
int count = 0; 
Mix4 (] in4a =new Mix4[20); 
int X = 0; 

while ( 



) ( 



m4a (x) = new Mix4 () ; 

m4a (x] . counter = m4a (x) .counter + 1; 

count = count + 1; 

count = count + m4a [x] .maybeNew (x) ; 

X = X + 1; 

} 

System. out .println (count + ^ 

+ m4a [1] .counter) ; 



} 



public int maybeNew (int index) { 
if ( 



) ( 



Mix4 m4 = new >3ix4(); 

m4. counter = m4. counter + 1; 

return 1; 

} 

return 0; 
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methods use instance variables 




p®®] Puzzle 




YouTjob is to take code snippets from the 
pooi and piace them into the bianic lines 
n the code. You may not use the same 
snippet more than once> and you won't 
need to use ail the snippets, Your goat 
s to malte a ciass that wiii compile and 
run and produce the output listed. 




Note: 
from 
used 



I 



r Each snippet 
the pool can be 
only once[ 



dCiStuff(x); 
obs.doStuff(x); 
ob$[x).doStuff(fdCtor); 
obs[x].doStuff(x); 



public class Pu2zle4 { 

public static void main(String [] args) { 

int y = 1; 
int X = 0; 
int result - 0; 
while (X < 6) { 



y * 10; 



> 

X = 6; 

while (X > 0) < 
result = result + 



} 

System, out, println( "result + result); 



> 

} 

class 



int ivar; 



doStuff (int 



.) { 



if (ivar > 100) { 
return 

> else { 

return 

> 



ivar = x; 
obs.ivar = x; 

obs[x] Jvar = x; ivar 
obs[x]Jvar = y; factor 

Puzzie4 [ ] obs = new Puzzie4(6]; P^^''^ 
Pu22ile4b [ ) obs = new Pu22le4b[6]; Private 
^uzzlie4b [ ] obs - new Pu^le4[6]; 



ivair + factor; 
ivar * (2 + factor); 
ivar * (5 - factor); 
ivar * factor; 



Puzzle4 
Puzzle4b 
Puzzle4b() 



x = x + 1; 
X = x - 1; 



int 

short 

obs [x] = new Pu22ie4b(x); 
obs [ 1 = new Puzzle4b{ ); 
obs [x] = new Pyzzle4b( ); 
obs = new Puz2ie4b( 
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puzzle: Five Minute Mystery 




Fast Times in Stim-City 

When Buchanan jammed his twitch-gun into Jai's side, Jai froze. Jai knew that Buchanan 
was as stupid as he was ugly and he didn't want to spook the big guy. Buchanan ordered Jai 
into bis bosses office, but Jai*d done nothing wrongs (lately), so he figured a little chat with 
Buchanan's boss Leveler couldn't be too bad. He*d been moving lots of neural-stimmers in 
the west side lately and he figured Leveler would be pleased. Black market stimmers weren't 
the best money pump around, but they were pretty hannJess. Most of the stim-junkies he'd 
seen tapped out after a while and got back to life, maybe just a little less focused than before. 

Leveler's 'office* was a skungy looking skinuner, but once Buchanan shoved him in, Jai 
could see that it'd been modified to provide all the extra speed and armor that a local boss Uke 
Leveler could hope for. "Jai my boy"*, hissed Leveler, ^'pleasure to see you again". "Likewise 
Vm sure,..'', said Jai, sensing the malice behind Leveler's greeting, "We should be square 
Leveler, have I missed something?" "Ha! You're making it look pretty good Jai, your volume 
is up, but Tve been experiencing, shall we say, a little 'breach* lately...'* said Leveler. 

Jai winced involuntarily, he'd been a top drawer jack-hacker in his day. Anytime someone 
■figured out how to break a street -jack's security, unwanted attention turned toward Jai. ^Tslo 
way it's me man", said Jai, "not worth the downside, I'm retired from hacking, I just move 
my stuff and mind my own bminess". "Yeah, yeah", laughed Leveler, "I'm sure you're 
clean on this one, but FU be losing big margins until this new jack-hacker is shut 
out!" "Well, best of luck Leveler, maybe you could just drop me here and Til go 
move a few more 'units' for you before I wrap up today", said Jai. 



"Fm afraid it's not that easy Jai, Buchanan here tells me that word is you're 
current on J37NE", insinuated Leveler. "Neural Edition? sure I play around a bit, so 
what?'\ Jai responded feeling a little queasy. "Neural edition's how I let the stim-junkies 
know where the next drop will be", explained Leveler 'Trouble is» some stim-junkie's stayed 
straight long enough to figure out how to hack into ray WareHousing database." "I need a 
quick thinker like yourself Jai, to take a look at my StimDrop J37NE class; methods, instance 
variables, the whole enchilada, and figure out how diey're getting in. It should..", "HEY!", 
exclaimed Buchanan, "I don't want no scum hacker like Jai nosin' around my code!" "Easy 
big guy", Jai saw his chance, "I'm sure you did a top rate job with your access modi.. "Don't 
tell me - bit twiddler!'', shouted Buchanan, "I left all of those junkie level methods public, 
so they could access the drop site data, but I marked all the critical WareHousing methods 
private. Nobody on the outside can access those methods buddy, nobody!" 

**I think I can spot your leak Leveler, what say we drop Buchanan here ofiT at the comer 
and take a cruise around the block", suggested Jai. Buchanan reached for his twitch-gun but 
Leveler 's stunner was already on Buchanan's neck, "Let it go Buchanan", sneered Leveler, 
'IDrop the twitcher and step outside, I think Jai and I have some plans to make". 
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What did Jai suspect? 
Will he get out of Leveler's skimmer with all his bones intact? 



methods use Instance variables 



Exercise Solufions 



class Clock { 
String time; 

void setTime( String t) { 
time - t; 

} 

Strfng getTimeO { 
return time; 



} 



} 



lass XCopy" compiles and runs as it stands I The 
^2 B4". Remember Java is pass by value, (which 
ss z. copy), the variable 'orig' is not changed by the 



class ClockTestDrive { 
public static void [iiain(String [] axgs) { 
Clock c = new Clock(); 
c.3etTiine("1245''); 
String tod = c.getTijne( ) ; 
System. out. println( ''time: " + tod); 



} 



Note: 'Setter methods have a return 
type by definition. 



Adass can have any number of these. 

A method can have only one of these. 

This can be Implicitly promoted. 

I pfBfer my instance variables private. 

i really means 'make a copy*. 

On*y setters should update these. 

A method can have many of these. 

I nefiiim something by definition. 

I shouldn't be used vuith instance variables 

I can have many arguments. 

By definition, I take one argument. 

These help create encapsulation. 

I ahvays fly solo. 



Instance variables, getter, setter, method 
return 

return, argument 

encapsulation 

pass by value 

Instance variables 

argument 

getter 

public 

method 

setter 

getter, setter, public, private 
return 
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puzzle answers 



Puzzle Soluticms 



Answer to the 5-minute mystery... 



public class Pu2zle4 ( 

public static void main (String [] args) { 
Puz2lfe4b [ ] obs = new Puzzle4b[6J; 

int y - I; 
int X - 0; 
int result = Oj 
while (X < 6) { 

obs[x] = new Pu2zle4b( ): 

obs[x] . ivcir - y: 

y - y * 10? 

X = X ♦ 1; 

) 

X = 6j 

while {X > 0) { 
X X - 1; 

result = result + obs[xl.do5tuff(x); 

> 

Systemroot .printing ^result " + result) ; 

> 

class Pur2le4b { 
int ivar; 

public mt doStuff(int factor) { 
if (ivar > 100) { 

return ivor * factor; 
> else { 

return ivor * (5 - foctar); 

> 

> 



Output 



> 



% java Puzzle4 
result 543345 



Jai knew that Buchanan wasn't the sharpest 
pencil in the box. When Jai heard Buchanan 
talk about his code, Buchanan never mentioned 
his instance variables. Jai suspected that 
while Buchanan did in fact handle his methods 
correctly, he failed to mark his instance variables 
private. That slip up could have easily cost 
Leveler thousands. 



Candidates: 



Possible output: 
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5 writing a program 

Extra-Strength Methods 




Let's put some muscle In our methods. We dabbied with variables^ played 
with a few objects, and wrote a little code. 8ut we were weak. We need more tools. Like 
operators. We need more operators so we can do something a little nnore interesting than, say, 
bark. And loops. We need loops, but what's with the wimpy while loops? We need for loops 
if we're really serious. Might be useful to generate random numbers. And turn a String 
into an tot, yeah, that would be cool. Better learn that too. Ar^d why don't we learn It aij by 
bulldmg something real, to see what it's like to write (and test) a program from scratch. Maybe 
a gamejike Battleships.That's a heavy-lifting task, so it'll take rwo chapters to finish. We'll build 
a simple version in this chapter, and then build a more powerful deluxe version in chapter 6. 
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building a real game 



Lef s build a Pattleshlp-style 
game: "Sink a Pot Com" 

It*s you against the computer^ but unlike the real 
Battleship game, in this one you don*t place any ships 
of your own. Instead, your job is to sink the computer's 
ships \ri the fewest number of guesses. 

Oh, and we aren't sinking ships. We're kilJing Dot 
Corns. (Thus estabUshing business relevancy so you can 
expense the cost of this book). 

Goal: Sink all of tlie computer's Dot Corns in the fewest 
number of guesses. YouVe given a radng or level, based 
on how well you perform. 

Setup: When the game program is latmched, the 
computer places three Dot Corns on a virtual 7x7 
grid. Wlien that*s complete, the game asks for your first 
guess, 

How you play: We haven't learned to budld a GUI yet, so 
this version works at the command-line. The computer 
will prompt you to enter a guess (a cell), that you'll type 
at the command-line as "A3", ""CS", etc,) - In response 
to your guess, you'll see a result at the command- 
line, either "Hit**, "Miss", or *You sunk Pets.com" (or 
whatever the lucky Dot Com of the day is). When 
you've sent all three Dot Corns to that big 404 in the 
sky, the game ends by printing out your rating. 
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tiA>r{s at icro; like Java arrdys 



You're going to build the 
Sink a Dot Com game, with 
a 7 X 7 grid and three 
Dot Corns. Each Dot Com 
takes up three cells. 



parr of a game Interaction 



Edil Window/ Haip 



%java DotComBust 
Enter a guess A3 
miss 

Enter a guess B2 
miss 

Enter a guess C4 
miss 

Enter a guess D2 
hit 

Enter a guess D3 
hit 

Enter a guess D4 

Ouch! You sunk Pets.com : ( 

kill 

Enter a guess B4 
miss 

Enter a guess 63 
hit 

Enter a guess G4 
hit 

Enter a guess G5 

Ouch? You sunk AskMe.com : ( 
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writing a program 



First a high-level design 

[ know we'U need classes and methods, but what 
Jd they be? To answer that^ we need more 
nation about what the game should do. 

, we need to figiu-e out the general flow of the 
t. Here's the basic idea: 



User starts the game 

6t3mc creates three Dot Corns 

§ :j Gdrne places the three boi 
Corns onto a virtuol grid 



Same play begins 

Repeat the following until there are 
no more Dot Coms^ 




Wr^ Prompt user for a guess 
^ CAZ"/CO", etc.) 



Check the user guess agair\st 
all bot Corns to look for a hit, 
miss, or kill. Take appropri- 
ate action: if a hit, delete cell 
(A2, 04, etc.). If a kill, delete 
Dot Com. 



Same finishes 

Give the user a rating based on 
the number of guesses. 



Kow we have an idea of the kinds of things the 
pCigTam needs lo do. The next step is figuring 
but what kind of objects we'll need to do the 

Erk. Remember, think Hke Brad rather than 
cry; focus first on the things in the program 
her thajfi the procedures. 



[ start K ^ttkJ^A^ i 



Same set-up 



O 



o o 



Get user 
guess 



miss 




remove loca- 
tion celf 



remove 
Dot Com 



yes 




^ diamond 



Whoa. Araal flow chart. 
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a simpler version of the game 



The "Simple Pot Com ^amc" 
a gentler iHtroductioH 

It looks like we're gonna need at least two classes, a 
Game class and a DotCom class. But before we build 
the fu]l monty Sink a Dot Com game, we'll start with 
a stripped-<iown» simplified version, Simple Dot Com 
Game^ We'll build the simple version in ^is chapter, 
followed by the deluxe version that we build in the 
n^wc/ chapter. 

Everything is simpler in this game. Instead of a 2-D 
grid, we hide the Dot Com in just a single mm. And 
instead of th-ree Dot Corns, we use one. 

The goaJ is the same, though, so the game still needs 
to make a DotCom instance, assign it a location 
somewhere in the row^ get user input, and when all 
of the DotCom's cells have been hit, the game is over. 
This simplified version of the 
game gives us a big head start 
on building die full game. 
If we can get this small one 
working, we can scale it up to 
the more complex one later 

In this simple version, the 
game class has no instance 
variahles» and all the game 
code is in the majn() method. 
In other words, when the 
program is launched and 
main() begins to run, it will 
make the one and only DotCom 
instance, pick a location for it (three 
consecutive cells on the single virtual 
seven-ceil row), ask the user for a guess, check the 
guess, and repeat until all three cells have been hit. 

Keep in mind that the virtual row is... virtual In other 
words, it doesn't exist anywhere in the program. As 
long as both the game and the user know that the 
DotCom is hidden in three consecutive cells out of a 
possibVe seven (starting at zero), the tow y\se\f doesn\ 
have to be represented in code. You might be tempted 
to build an array of seven ints and then assign the 
DotCom to three of the seven elements in the array, 
but you don't need to. All we need is an array that 
holds just the three cells the DotCom occupies. 



Safw starts, and creates ONE DotCom 
and gives it a location on three cells in 
the single row of seven cells. 

Instead of 'A2'\ YA", and so on, the 
locations ore just integers (for example: 
1,2,3 ore the cell locations rn this 
picture- 




Gcrrse play begins. Prompt user for 
Q guess, then check to sec if it hit 
any of the DotCom's three cells. 
If a hit, increment the numOf Hits 
variable. 

Gcme finishes when all three cells have 
been hit (the numOf Hits variable val- 
ue is 3), and tells the user how many 
guesses it took to sink the botCom, 



A complete game Interaction 

I File Edk Wifldow Help O&scray ~ 



%java SimpleDotComGame 
enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 
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writing a program 



^veloping a Class 



a programmer, you probably have a methodology/ 
ess/approach to writing code. Well, so do we. Our 
tnce is designed to help you see (and learn) what 
?Ve thinking as we work through coding a class. It 
"i necessarily the way we (or you) write code in the 
World. In the Real World, of course, you'll follow 
approach your personal preferences, project, or 
oyer dictate. We, however, can do pretty much 
ver we want And when we create a Java class as a 
ing experience", we ustially do it like this: 

Figure out what the class is supposed to do. 

List the instance variables and methods. 

Write prepcode for the methods. (You'll see 
this in Just a moment) 

Write test code for the methods. 

Implement the class. 

Test the methods. 

Debug and reimplement as r^eeded. 



The three things well write for 
each class: 



real code 



This bar is displayed on the next set of pages to tell 
you which part you're worl^ing on. For example, if you 
see this picture at the top of a page, it means you're 
working on prepcode for the SimpleDotCom class. 



SImpleDotCom class 




Express gratitude that we don't have to test 

our so-called /eam/nge>penenceapp on |; f|i0 

actual live users. r, 



real code 



prep code 

A form of pseudocode, to help you focus on 
the logic without stressing about syntax. 

test code 

A class or methods that will test the real code 
and validate that it's doing the right thing. 

real code 

The actual implementation of the c!ass. This is 
Java code. 



□ write prep 

□ write t«*«x** 



flex those dendrft^s. 

How would you decide which class or classes 
to build y^m, when youVe writing a pro9ram7 
Assuming that all but the tiniest programs 
M€d more than one class {If you're following 
good OO principles and not having one class 
do many different Jobs), where do you start? 



write 



code 



iteatcodelnol 
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SImpleDotCom class 







real code 









SirnpleDotCom 



intQrocationCells 



String checkYours^Strinc) gudss) 
votd setLocationCe1ls{tnlO \oc) 



You*ll get the idea of how prepcode (our version of pseudocode) works as you 
read through this example. It*s sort of half-way between real Java code and a plain 
English description of the class. Most prepcode includes three parts: instance 
variable declarations, method declarations^ method log^c. The most important 
part of prepcode is the method logic, because it defines what has to happen, 
which we later translate into how, when we actually write the method code. 

DECLARE an im array to hold the location cells. Call rt locaUonCdk. 
DECLARE an frit to hold the number of hrts. Call It numOfH'ns and SET rt to 0. 



DECLARE a checkYourzetfO method that takes a String for the users guess ('V\"y\ etc.). 
checks it and returns a result representing a "hit", "miss", or "kill". 

DECLARE a ^etLocationCelkO setter method that takes an int array (which has the three cell 
\ocat\ons as ints etc.). 



METHOD: String checkYourself(Strmg userGuess) 
GET the user guess as a String parameter 
CONVERT the user guess to an int 

REPEAT with each of the location cells in the int array 

// COMPARE the user guess to the location cell 

I IF the user guess matches 

INCREMENT the number of hits 
// FIND OUT rf it was the last location cell: 
IF number of hits is 3, RETURN "kill" as the resuK 
ELSE itwasnot a kilUo RETURN'-hit'^ 
END IF 

ELSE the user guess did not match^ so RETURN "miss" 
END IF 
END REPEAT 
END METHOD 



n 



METHOD: void setLocaticnCetis(intf] celtLocatJons) 
GET the cell locations as an ini array parameter 

ASSIGN the cell locations parameter to the cell locations insunce variable 
END METHOD 
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> Writing the method 
ipiemeiitatioHs 

write the real 
method code now, and get 
I this puppy workiKQ. 

> Before we stm coding the 
^methods, though, let's back 
up and write some code to 
i^^the methods. That's right, 
»*re writing the test code 
ifore there's anything to testi 

^The concept of writing 
die test code first is one of 
the practices of Extreme 
Programming (XP), and 
it can make it easier (and 
fiaster) for you to write your 

f Ct^de. We're not necessarily 
saying you should use XP, 
but we do like the part about 

^wiung tests first. And XPjust 
setunds cooK 




Extreme Programming (XP) 



5me Programming(XP) h a newcomer to the software 
*lopment methodology world. Considered by many 
10 b6*the way programmers really want to worklXP 
erged In the late 90's and has been adopted by 
ipanies ranging from the two-person garage shop 
> the Ford Motor Company.The thrust of XP is that the 
tomer gets what he wants, when be wants it, even 
tn the spec changes late In the game. 

XP is based on a set of proven practices that are all 
designed to work together^aithough mariy folks do pick 
3nd choose,and adopt only a portion of XP's rules. These 
practices include things like; 

Make small, but frequent, releases. 

faDevelop in iteration cycles. 



Don't put in anything that's not in the spec (r^o matter 
how tempted you are to put in functionality "for the 
future*0. 

Write the test code ftrst. 

No killer schedules; work regular hours. 

Refactor (Improve the code) wher^ever and wherever you 
notice the opportunity. 

Don't release anything until it passes all the tests. 
Set realistic schedules, based around small releases. 
Keep it simple. 

Program in pairs, and move people around so that 
everybody knows pretty much everything about the code. 
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Writing test code for the StiMplePotCom class 

We need to write test code that can make a SimpleDotCom object 
and run its methods. For the SimpleDotCom class, we really 
care about only the checkYourselfi) method, although we will have 
to implement the setLocaiionCellsO method in order to get the 
checkYourselfO method to run correcdy. 

Take a good look at the prepcode below for the ckeckYoursdJO 
method {the setLocatkmCells() method is a no-brainer setter method, 
so we're not worried about it, but in a 'real' application we might 
want a more robust 'setter' method, which we woiUdMr2m.t to test). 

Then ask yourself, "If the checkYourself() method were 
implemented, what test code could I write that would prove to me 
the method is working correcdy?" 



^ased Oh this prepcode: 



Here's what we should test: 



METHOD String checkVourseifllString uBerCuess) 
GET the user guess as a String paranneter 
CONVERT the user gue%% to an int 
REPEAT with each of the location cells in the int array 
// COMPARE the user guess to the location cell 
IF the user guess matches 

INCREMENT the number of hrts 

// FIND OUT if it was the last location cell: 

IF number of hits is 3. RETURN "Kill" as the result 

ELSE awasnolakilUoRETURN"Hr 

END !F 

ELSE the user guess did not match, so RETURN "Miss" 
END If 
END REPEAT 
END MFTHOD 



1 . Instantiate a SimpleDotCom object. 

2. Assign it a location (an an^y of 3 ints, like 
{2.3.4}). 

3. Create a String to represent a user guess 
("2", "O". etc.). 

4. Invoke the checkYourself() method pass- 
ing it the fake user guess. 

5. Print out the result to see If it's correct 
Cpassed'* or -failed"). 
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-^eal code 



^lAaybe Tm missing some- 
Ire, but how exactly do 
Elhifi a test on something 
tiloesn'tyet existi? 



t^'VcJU don't. We never said 
I start by running the test; 
I start by writing the test. At 
Itkne you wnte the test code, 
rt't have anything to run 
t so you probably won't 
fable to compile It until you 
*e 'stub' code that can Conn- 
ie t jt that will always cause 
t to fail (like, return null.) 

Olflvifrn I stril don't sea the 
^ .Why not wait until the 
y$ written, and then whip 
liestcode? 



• The act of thinking through 
fiting) the test code helps 
^your thoughts about what 
ethod Itself needs to do. 

I as your implementation 
f'h done/you already have 
; code Just waiting to validate 
tiesrdes,you know if yoo don't 
lit now, you'll newer do It. 
e's always something more 
sting to do. 

^ write a little test code, 
vfite only the implementa- 
tcode you need In order to 
i that test.Then write a little 
► test code and write only 
f implementation code 
led to pass that new test. At 
i test iteration, you run all 
kpreviousiy-wrltten tests, so 
t you always prove that your 
r code additions don't break 
ausly-tested code. 
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Test code for the SlmplePotCom class 



public class Sia^laDotCooiTestDrive { Vatt ^ 

public static void main (String [] args) { Wl 
Sis^leDotCom dot = new 5iii^leDotCoiii() ; 



int[] locatJ^ons - {2,3,4}; 
dot* SAtLocationCells (locations) ; 



string userGuess = ''I" ; 



wake d 
wet- 



String result = dot.chec}cyour8el£(u8erGuess) ; 
String testRasult = "failed"; }^ ^}^'^V<»^s<\fO 



if (result. equals ( ''hit") ) ( 
testRasult - '^passed"; 



> 



System, out. println(te8tRftault) ; 



rpen your pencil 



in the next couple of pages we Implement the SImpleDotConn class, 
and then later we return to the test class. Looking at our test code 
above, what else should be added? What are we /?of testing in this 
code^that we should be testing for? Write your ideas (or lines of 
code) below: 
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The checkYourself 0 method 

There isn't a perfect mapping from prepcode to javacode; you'll see a few 
adjustments. The prepcode gave us a much better idea of what the code needs to 
do, and now we have to find the Java code that can do the how. 

In the back of your mind, be thinking about parts of this code you might want 
(or need) to improve. The numbers are for things (syntax and language 
features) you haven't seen yet. They're explained on the opposite page. 



OET the user 
guess 

CONVERT 

the user guess to 
an int 



each cei! in the mt 
array 

IF the user guess 
maTches 



INCRBH^NT 

the nun^ber of 
hits 



public String checkYourself (String stringGuess) { 



// FIND our if 

it. was the last cell 

IF number of hits 
is 3, 

RETURN in 

as the result 

ELSE ft was 

not a kiiL so 
RETURN hit 

BISB 

RETURN 



the avray 

i«i a Kit/ 



int guess = Integer. paxseint (stringGuess) ; < — , i , . , 

String result = "miss"; <= ^ '^^e a vaHable io Md tK« ^wult we'll 

P"""- as ihe default 

'••«• we assume a "miss") 

for (int cell : locstionCells) { 
if (guess = cell) { 
result = "hit"; 
ntumOf Hits++ ; > 
break; -^ ^^ 
} // end if oi^o^ ^dli 

} // and for 

if (numOfHits == locationCells . length) { 
result = ^^kill''; 

} // end if 

System, out -println (result) ; 



weVe cut the loof, but let's see 

dead I ti.es; a«d dKa^je th, 
<^«sult StWhj to Yill" 



weVe 



— display tKe result -for tKe usev 

return result; '^'^'<^ ^ <^ "^'""^ 

^;^<W«tK< result ba£k to 
) // «ad, method the Mllinj method 
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the new stuff 

: things we haven't seen before 
Sn this page. Stop worrying! The 
[ of the details are at the end of 
^chapter. This isjust enough to let 
lifeie«p going. 



Converting a 
String to an Int 



i 



'it. 



Integer.parseint ("3") 



a^d Li^. it to iK. ..t variable ■ ''^^"'^(UlU..." "'^ '^^ 

for Cijiitjcell : locationCells) { } 



ahd aiii^r. 
The for loop 



r>.da..ava.iabl.tKatw;IUoldl.,^^^ 
W tK. av^ay. Eadh t., 0,,^ , 

^-y-^.tlth..a.e.o.o...|^:;Xt 



m t>^' 



The post- increment 
operator 



numOfHits++ 



Vrfo^rdS) in^V-emtr^t by ))■ 
tKis as saying nUmD^Hiii = 



break statement 



break; 



^eii you ou{: a loof. )»*M*^cdlatcly. Rijkt K^v-c 

No iicva'tjorij no boolcark ^usj C^A 0**"^ ^ow | 
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prap code 

Q^*What happens In 
Integer.parselntO If ihethfng you 
pass Isn't a number? And does It 
recognize spelled-out numbers, 
llke'three"? 



A: 



L- Integer.parselntO works only 
on Strings that represent the ascif 
values for digits (0,1,2,3,4,5,6,7/8,9). 
If you try to parse something like 
^two"or''blurp';the code will blow 
up at runtime, (By blow up, we 
actually mean throw on exception, 
but we don't talk about exceptions 
until the Exceptions chapter So for 
now, blowup is close enough.) 



^^-In the beginning of the 
book/ there was an example of a 
for loop that was really different 
from this one — are there two 
different styles of for loops? 

>/\^!Yes] From the first version of 
Java there has been a single kind 
of for loop (explained later In this 
chapter) that looks like this; 

for (inti = 0;l < 10;i++){ 

// do something 10 times 

) 

You can use this format for any 
kind of loop you need. But... 
beginning with Java 5.0 (Tiger), 
you can also use the enhanced for 
loop (that's the official description) 
when your loop needs to iterate 
over the elements in an array (or 
another kind of collection, as you'll 
see In the next chapter). You can 
always use the plain old for loop 
to iterate over an array, but the 
enhanced for loop makes it easier. 



Flhal code for StmpkPotCom and SimplePotCowTester 

public class SinploDotComTefltDriv© ( 

public static void main (String! ] args) { 
SimpleDotCom dot - new SimpleDotComO ; 
into locations ^ {2,3,4}; 
dot . setLocationCells (locations) ; 
String userGuess = "2"; 

String result = dot . checkYourself (userGueas) ; 

) 



public class Sin^jleDotiCom { 

int I ] locationCells; 
int nujnOfHits = 0; 

public void adtliOcatloaCttlla (int ( ] Iocs) ( 
locationCells = Iocs; 



public String checkYouraalf (Stri 
int guess = Integer .parselnt ( 
String result = '"miss"; 
for (int cell : locationCells 
if (guess == cell) { 
result = ''hit"; 
numOfHits++; 
break; 

) 

) // out of the loop 

if (numOfHits =- 

locationCells. length) ( 
result = ''kill''; 

} 

System, out .print In (result) ; 
return result; 

) // ciore me u hod 
) // close class 



There's a little bug lurking here. Itcorrtptles and 
runs, but sornetimes... don't worry about It for now, 
but we wiff have to face it a Httte later. 



ng stringGuess) { 
stringGuess) ; 

) { 



What should we see 
when we run this code? 

The test code makes a 
SimpleDotCom object 
and gives it a location at 
2,3AThen it sends a fake 
user guess of "2" Into the 
checkYouselfO method. 
If the code is working 
correctly, we should see the 
result print out: 
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real code 




irpen your pencil 



We built the test class, and the SimpleDotCom class. But we still haven't 
made the actual game. Given the code on the opposite page, and the spec for 
the actual game, write in your ideas for prepcode for the game class. We've given 
you a few lines here and there to get you started. The actual game code is on the 
next page, so don't turn the page until you do this exerdsel 

You should have son^ewhere between 1 2 and 1 8 lines (including the ones we wrote, 
but not including lines that have only a curly brace). 

METHOD pubilc statk. void main (itrmg Q orgs) 

DECLARE an int variabfe to hold the number of user guesses named numO/^uesses 



COMPUTE a rar^dom number between 0 and ^ that will be the starling locadon cell posriion 



The SimpleDotComGame 
needs to do this: 

1. Make the single 
SrnnpleDotConn Object. 

2. f\/\ake a location for it (three 
consecutive cells on a single 
row of seven virtual cells), 

3. Ask the user for a guess. 

4. Checkthe guess. 

5. Repeat until the dot com is 
dead . 

6. Tell the user how many 
guesses it tooL 



A complete gawe InteracKoii 

I File Edift Window Hetp Runaway 



WHILE the dot com is slill altve : 

GET user input from the command line 



%java SimpleDotCoraGame 
enter a number 2 
hit 

enter a number 3 
hit 

enter a number 4 
miss 

enter a number 1 
kill 

You took 4 guesses 
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Prepcode for the Simple^ofCom&ame class 
Everything happens (h malnO 

There are some things you'll have to take on faith. For example, we have one 
line of prepcode that, says, "GET user input from command-line". Let me tell 
you, that's a little more than we want to implement from scratch right now. But 
happily we're using OO. And that means you get to ask some o^/i^ class/ object 
to do something for you, without worrying about haw it does it, When you write 
prepcode, you should assume that som^hm you'll be able to do whatever you 
need to do, so you can put all your brainpower into working out the logic. 



publk rtcrtic vo\d main (String [] orgs) 

DECLARE an int variable to hold the number of user gueises, named numOpGuess^. set rt to 0- 
MAKE a new SimpleDoiCom instance 

COMPUTE a random number between 0 and 4 that will be the starting location cell position 

MARE an int array with 3 ints osing the randomty-generated number, that number incremented by I. 
and thai number incremented by 2 (example: 3.1.5) 

INVOKE the ^tlocatiooCeifsO method on ihe SimpleDotG^m instance 

DECLARE a boolean variable nepresenting the state of the game, named itAitve. SET rt to true 



WHILE the dot com Is still aJive (isAfive == true) : 
GET user input from the command line 
// CHECK the user guess 

INVOKE the checkYours^tfO method on the SimpleDoiCom insunce 
INCREMENT numOfGuesses variable 
// CHECK for dot com death 
IF result is "kill" 

SET isAiive to false (which means we won't enter the loop again) 



PRINT the number of user guesses 



END IF 
END WHILE 
END METHOD 



m&tacognitive tip 

Don't work one part of the brain for too long a stretch at one time. 
Working )ust the left side of the brain for mora than 30 minutes 
is like working just your left arm for 30 minutes. Give each side 
of your brain a break by switching sides at regular intervals. " 
When you shift to one side, the other side gets to rest and 
recover. Left-brain activities include things like step-by-step 
sequences, logical problem-solving, and analysis, while the 
right-brain kicks in for metaphors, creative problem-solving, 
pattern-matching, and visualizing. 
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Your Java program should start with a high- 
level design. 

Typically you'll write three things when you 
create a new class: 

prspcode 

testccde 

real (Java) cod$ 

Prepcode should describe what to do, not how 
to do it. Implementation comes later 

Use the prepcode to help design the test 
code. 

Writ© test code before you implement the 
methods. 



Ctioose for loops over while loops when you 
know how many times you want to repeat the 
loop code. 

Use the pre/post ir)crerr)er)i operator to add 1 
to a variable (x++;) 

Use the pre/post decrement to subtract 1 from 
a variable (x-;) 

Use Integer .parselntO togettheint 

value of a String. 

Integer. parselntO WOrks only if the 

String represents a digit (^^M^7^ etc.) 

Use break to leave a loop eariy (i.e. even if 
the boolean test condition is still true). 



How many 
hits did you get 

test miflhth? 



Including 
repeat visitors? 



Vfes. 




^(md<p ^n^Mt ^(^tf^ ^<m^ ' 
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prapcodei 




The game's maihO method 



Just a5 you did with the SimpleDotCom class, be thinking about parts of this code 
you mightwant (or need) to improve. The numbered things ^ are for stuff we 
want to point out- They're explained on the opposite page. Oh» if you're wonder- 
ing why we skipped the test code phase for this class, we don't need a test class for 
the game. It has only one method, so what would you do in your test code? Make 
a separate class that would call mainO on this class? We didn't bother. 



public static void main (String [] args) ( w^aWc ^ "^^^ ^^"^ 



DECLARE a vari^ 
able to hold user 
guer-s count, set it 
to 0 



MAKE ^;SimpleDoi- 

Coiv. object 

COMPUTE A 

rarid'om nurnbef^ 
between Q and 4 

MAKE 3n im arr^iy 
wHh 3 cell loca- 
nons. and 

tNVOKE setLoca- 
tionCells opt the dot 
coin obj^a 

DECLARE abool 
eari isAlive 

WHILE the dot 

conn IS iiiW alive 

GET u^cr inpLft 

// CHECK 

INVOKE checkVo 
urselfQ on dot conn 

INCREMENT 

nuf-nOfGuessas 

IF result is'VJH" 

SET garr^eAlive to 
fal^e 

PRINT the nunnber 
of user guelies 



int nuznOf Guesses = 0; 



GamaHdlp«r help«r = naw G«mAEalpar() ; 



tK* r^etikod foV grbtin^ i^Str input 

now, pretend its part of Java 
SimpleDotCom theDotCom = nsw SimpleDotCom () ; ^ . ^)^^ i^^ ton* J6\ui 

int randomNum = (int) (Math . random () ♦ 5) a varvaotn number (cr the (\rti 

U\l and use \iio make the uW 



int[] locations ■ (randamMum, randoosNum+l , randoiaNum+2 } ; 

theDotCom, setLocationColls (locations) ; ^ ^-^^ ^ot torn iti lo<^ti<»^ ^^^T 
boolean isAlive = true; 

v^^^--^ make a boolean variable to tradk wKetKcr t>i€ jame 

is still alive, to use in the while loop test repeat 
^^'-^ while jame is stilt alive- 



.t Str'^*^ 



while {isAlive = true) i 

string guess = helper. getUs^lnput ("^enter a number") ; 

String result = theDotCom. ohedkYour self (guess) ; ^sk j i 

^the 3ue« "^^^^^^^ 
nuinOf Guesses++ ; inerement t^i ^Ci^i in a ^t^j,^ *^*^4 

if (result. equals (")cill-)) ^ ;^ ^ ^ ir»? r , * 

isAlive = false; < ^e-tt^ttr tKe loop) and print user ju^ ^ 

System. out. println C^You took ^ + numOfGuesses + guesses"); 

) II close if 
} // close while 
) // close main 
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randomO and ge-tVseiinputO 

to things that need a bit more 
plaining, are on this page. This is 
t a quick look to keep you going; 
r details on the GameHelper 
t are at the end of this chapter. 



Moke a random 
number 



w« Kav« ^ riTf ^ J^^bl*, 



writing a program 



I 



int randomlfum » O^t) C^ath. random C) * 

t r r 

A tlasi tKat dowe* ^^tkod of 
wilK Java. /viaiK diasi. 



5) 



l/Ve declare an ml variable K«ld 
the vandow M*r«ber we jet batk. 



string guess = helper. getUserlnputC^'enter a number'^) 



Setting user input 
using the SomeHelper 
class 



All initar^e vje r^ade earlier, 
of a tlass -fcKai we bwlt -fco 
helf wrtli -tbe jawe. t3\\t& 
^aw^eHelfer and haven't 
seen 'rt yet ^yo<* will). 



T 

9«t badi^ V?dir 



r 



iK^i aiks t^^« us^ for ^mand- 
ustt- hits RETURN/, awi gWcs bd^k 

tl^^ result as d String- 
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prop cods ^B code 




One last class.* GameHelper 

We made the dot com class. 
We made the game class. 

AD that's left is the helper cIbss — the one with the 
geiUserlnputO method. The code to get conumand- 
line input is more than we want to explain right now. 
It opens up way too many topics best left for later. 
(Later, as in chapter 14.) 



Just copy* the code below and compile it into 
a class named GameHelper. Drop all three 
classes (SimpleDotCom, SimpleDotComGame, 
GameHelper) into the same directory, and make it 
your working directory. 




Whenever you see the flHJ^<** logo, you*re see- 
ing code that you have to type as-is and take on ftuth. 
Trust iL You'll learn how that code works later. 



Code 



import java.io.*; 
public cl&ss GameHelper { 

public String gatUserlnput (String prompt) { 
String inputLine = null; 
Systam.out .print (prompt + ; 
try { 

Biif ferednaader ia - new BufferftdReader ( 
new InputStreAiDReadar (Syatifim.in) ) ; 
inputLine = ia , readLine () ; 

if (inputLine , lengfth () = 0 ) return null; 
> cAtch (lOException a) { 

System. out. printlnC'IOfixception: + e) ; 

) 

return inputLine; 



*W© know how much you enjoy typing, but for those fare 
moments When you'd raVher do someMng 6\^, wa've fwade 
the Ready-bake Code available on wlckedlysmarLconn. 
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play 



Here's what happens when we 
run It and enter the numbers 
1,2,3,4,5,6. Looktn good, 

A complete flame lutfiractloh 

(your nnileage may vary) 

I File Edit wrndow Help SmUe 



What's this? A bug'l 

&asp\ 

Here's what happens when we 
enter 1,1,1. 

A different game interactloH 

(ylkes) 

I file Edft Window Helo Falni 



%java SimpleDotCoraGame 
enter a number 1 



enter a number 1 



enter a number 1 



You took 3 guesses 




H^^en your pencil 

It's a cliff-hanger! 

will we And the bug? 
Will weWxthe bug? 



Stay tuned ffcrthe next chapter, where we answer 
these questions and more... 

And In the meantinrie, see If you can come up with 
Ideas for what went wrong and how to fix It. 



5;java SimpleDotComGame 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a number 5 
hit 

enter a number 6 
kill 

You took 6 guesses 



you are here > 113 



for loops 

More about for loops 

We've covered all the game code for this chapter (but we'll pick it up again 
to finish the deluxe version of the game in the next chapter). We didn't 
want to interrupt yow work with some of the details and background info» 
so we put it back here. We'll start with the details of for loops, and if you're 
a C-H- prograimner, you can just skim these last few pages... 



Regular (non-enhanced) for loops 

forCint i = 0; i < 100; { } repeat 



What it means in plain English: "Repeat 1 00 times/ 
How the compiler sees it: 

+ create a variable / and set It to 0. 

* repeat while / Is less than 100. 

+ at the end of each loop Iteration, add 1 to / 

Part One: Mtlaltzation 

Use this part to declare and Initialize a variable to use within the loop body. 
You'll nr>ost often use this variable as a counter You can actually initialize more 
than one variable here, but we'll get to that later In the book. 

Pa rt Two: boolean test 

This Is where the conditional test goes. Whatever's In there. It must resolve to a 
boolean value (you know, frue or You can have a test like (x >= 4), or you 
can even invoke a nr^ethod that returns a boolean. 

PBrtlhr^B\ iteration expression 

In this part put one or more things you want to happen with each trip through 
the loop. Keep In nnind that this stuff happens at the end of each loop. 
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through a loop ^ 

i = 0; i < 8; i++) ( 
ft.out -println (i) ; 



.OUt.printlnCMone") ; 



output; 




true 



enter loop 
bocfy 



•done- 
) bdow loop) 



pnnt the value 
of/ 



increment / 
(the iteration 
expression) 



it between for aHd while 

rioop has only the boolean test; it doesn't have 
k-in inittadzatlon or Iteration expression. A while 
Ifc good when you don't know how many times to 
l«nd just want to keep going while some condl- 
But If you /fnowhow many times to loop 
^length of an array,? times, etc^a forloop Is 
Here's the loop above rewritten using while: 



i = 0; ^ 



'mile (L < 8) { 

Systam.out .println (i) ; 



it«n.out .println (''done") ; 




Pre and Post Increment/Decrennent Operator 

The shortcut for adding or subtracting 1 from a variable. 

X++; 

Is the same as: 

X = X + 1; 

They both mean the same thing in this context 
"add 1 to the current value ofx'or "/nt remenf x by V 
And: 

X—; 

Is the same as: 

X = X - 1; 

Of course that's never the whole story. The placement of the 
operator {either before or after the variable) can affect the re- 
sult. Putting the operator before the variable (for example, ++x), 
means, "firsfjncrementx by Tand then use this new value of x/ 
This only matters when the ++x Is part of some larger expres- 
sion rather than just in a single statement. 

int X = 0; int z = -H-x; 

produces: x is 1,2 Is 1 

But putting the ++ offer the x give you a different result: 

int X 0; int z = x++; 

produces: x Is 1, but z/s^>l z gets the value of x and theny. is 
Incremented. 
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enhanced for 



The enhanced for loop 



Beginning with Java 5.0 (Tiger), the Java language has a second kind o£ for loop 
caJled the enharued for, that makes it easier to iterate over aU the elements in an 
array or other kinds of collections (you*ll learn about collections in the next 
chapter) . That's really all that the enhanced for gives you — a simpler way to walk 
through all the elements in the collection^ but since it's the most common use of a 
/or loop, it was worth adding it to the language. Well revisit the enhanced for loop in 
the next chapter, when we talk about collections that aren*t arrays. 



VttUrt -.tn-dtor. variable Ac Colo^ (.^ 



for CString name : nameArray) { } 

XL. . 



The i„ ^< i,CUcr.i el"-** 



What It means in plain English: "For each element in nameArray, assign the 
element to the 'name' variable, and run the body of the loop." 



How the compiler sees It: 

♦ Create a String variable called name and set it to null. 

* Assign the first value In nameArray to name. 

+ Run the body of the loop (the code block bounded by curly braces), 
■f Assign the next value In nameArray to nan^^e. 
+ Repeat while there are still elements in the array. 



Part One! Iteration variable declaration 

Use this part to declare and Initialize a variable to use within the loop body. With each 
iteration of the loop, this variable wilt hold a different elennent from the collection. The 
type of this variable must be compatible with the elements in the arrayl For example, 
you can't declare an /nt Iteration variable to use with a SfWn^O array. 



Part Two: the actual collection 

This must be a reference to an array or other collection. Again, don't worry about the 
of^er non^array kinds of collections yet— you'll see them in the next chapter. 
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writing a program 



Converting a String to an int 

Int guMB a latagftT . gar«In t { ttringSoM ■) ; 

The user types his guess at the command- 
Ine^when the game prompti hIm.That 
ipoess comes in as a String r27'0"etc.) , 
:and the game passes that String into the 
hfeckYourselfO method. 

Bat the cell locations are simp)/ ints In an 
array, and you can't connpare an Int to a 
String. 

For example, this won't work: 

String num =^'2"; 
intx= 2; 

if(x=num) // horrible explosioni 

Tf-ying to compile that makes the compiler 
aughand mock you: 



operator == cannot be applied to 
int, java - lang . String 



if (x 



num) { ) 



So to get around the whole apples and 
otranges thing, we have to make the 5fr/^5 
*2'into the int 2. Built Into the Java class 
library is a class called Integer {that's right 

Integer class, not the int primhWe), 
and one of its Jobs is to take Strings that 
fepresent numbers and convert them into 
dcfua/ numbers. 



teger.parseint C^^S") 

/ 

a rrrt^vod ih iMt |ht<6cy 

dan i^i^i knows Kow -to 
>ai^" a Siting Into tiic 



Castmg 
primitives 




long 



0 



can be cost to 



but you mfght 
lose something 



short 



In chapter 3 we talked about the sizas of the various primitives, and how you 
can't shove a big thfng directly Into a small thing: 
long y = 42; 

int X = y; // won't con^>ila 

A long is bigger than an int and the compiler can t be sure where thai long has 
been. It might have been out drinking with the other longs, and taking on really 
big values, To force the compiler to Jam the value of a bigger primitive variable 
into a snnaller one. you can use the cast operator. II looks like this: 

long y = 42; // so fax so good 

int X = (int) y; // x = 42 aoolf 

Putting In the c^st tells the compiler to take the value of y, chop It down to m\ 
size, and set x equal to whatever is left. If the value of y was bigger than the 
maximum value of x. then what's left wfll be a weird (but caicuiable*) number: 

long y = 40002; 

// 40002 axc««ds th« 16-bit liinit of a short 

abort X = (short) y; // x now equals -25534! 

Still, the point is that the compiler lets you do It. And lef s say you have a ffoal- 
ing point number, and you just want to get at the whole number (inf) part of iL 



float f = 3.14f; 
int X = (int) f ; 



// X will equal 3 



And don1 even think about casting anything lo a boolean or vice versa— just 
walk away. 

molvBS sign bits, binary, two's compi6n]eni' and other geekery. aii of which 
are discussed at the beginning of appendix B. 
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exercise: Be the JVM 




BE JVM 



The Java file on liis page 
represents a complete source 
file. Your job is to play JVM 
aiul deferniiJie wKat would be 
the outpirt: when flie 
program nms? 




class Output { 



'4 java Output 
12 14 



public static void main (String [] args ) { 
Output o = new Output(); 
o.go() ; 

> 

void go() { 
int y = 7; 

for(int X = 1; X < 8; x++) { 
y++; 

if (x > 4) { 

System^out. print (++y " "); 

} 

if (y > 14) { 

System. out .print In ( " x - + x); 
break; 

> 

> 

> 



-or- 



File £tH yVntkw lixetsa 



^- java Output 
12 14 X = 6 



-or- 
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* java Output 
13 IS X = 6 



writing a program 



Code Magnets 

A working Java program Is all scrambled up on the fridge. Can you 
reconstruct the code snippets to make a working Java program that 
produces the output listed below? Some of the curly braces fell on the 
floor and they were too small to pick up, so feel free to add as many of 
those as you need! 
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puzzle: JavaCross 




How does a aossword puzzle 
help you learn Java? WelUII 
of th e words are Java related. 
In addition, the clues provide 
metaphors, puns, and the like. 
These mental twists and turns 
bum alternate routes to Java 
knov/iedge, right into your 
brainl 



Across 

K Fancy computer word 
for build 

4. Multi-part loop 

6. Test first 

7. 32 brts 

10. Method's answer 
11- Prepcodfr*sque 
13. Change 
15. The big toolkit 

17. An array unit 

18. Instance or local 



20. Automatic toolkit 

22. Looks like a primitive, 
but- 

25. Un-castable 

26. Math method 

28. Converter method 

29, Leave early 



Down 

Z Increment type 
3. Cass's workhorse 

5. Prelsatypeof 

6. for"^ iteration 



7. Establish first value 

8. While or For 

9. Update an fnstance variable 
12, Towards blastoff 

14. A cycle 

1 6. Talkative package 

19. Method messenger 
(abbrev.) 



21. As if 

23. Add after 

24. P) house 

26, Compile it and _ 

27. ++ quantity 



writing a program 




Mixed 



Ashort Java program Is listed below. One block of the program 
is missing. Your chaifenge is to match the candidate block of 
code (on the left), with the output that you'd see If the block 
were inserted, Not all the lines of output will be used, and some 
of the lines of output n^ight be used nnorethan once. Draw lines 
connecting the candidate blocks of code with their matching 
command-line output. 



class MixForS { 

public static void main (String [] args) ( 
int X = 0; 
int y = 30; 

for (int outer = 0; outer < 3; outer++) ( 
for (int inner = 4; inner > 1; inner--) 



y = y - 2; 
if (X == 6) { 
break; 

} 

X = X + 3; 



3^ 



y - y - 2; 

} 

System, out .println (x + + y) ; 
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exercise solutions 



Be the JVM: 

Class Output { 

public static void main (String [J args) { 
Output o = new Output ( ) ; 
o.go( ) ; 

} 

void go{ ) { 
int y = 7; 

for(int X = 1; X < B; x++) { 
y++; 

if (X > 4) { 

System, out .print (++y + " ) ; 

> 

if (y > 14) < 

System. out .printing x = " + x)j 
break; 

> 



bid you remember to factor in the 
break statement? How did that 
affect the output? 



Code Magnets: 

class MultiFor { 

public static void main(Strir\g [] args) { 

for (int X = 0; X < 4; x++) { 

for(int y = 4; y > 2; y— ) { 

Sy8tempOut.println(x + " " 4- y); 

} 



if (X = 
X++; 

} 



- 1) i 



What would happen 
if this code block came 
before the y for loop? 



I java Output 
13 15 X = 6 



java MultiFor 
0 4 

0 3 

1 4 
1 3 
3 4 
3 3 
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writing a program 





■anaiaiiBDBH 



Candidates; 
X « X ^ 



Possible output: 



6 get to know the Java API 



Using the Java Library 




Java ships with hundreds of pre-built classes. You don't have to 

reinvent the wheel If you know how to find what you need in the Java library, knowr^ as 
the Java API, You'vegot better things to do. If youVe going to write code, you might as weil 
write only the parts that are truly custom for your application. You know those programmers 
who walk out the door each night at 5 PM? The ones who don't even show up until 1 0 AM? 
They use the Java API. And about eight pages from now, so will you.The core Java library 
is a giant pile of classes Just waiting for you to use like building blocks, to assemble your own 
program out of largely pre-built code, The Ready-bake Java we use in this book Is code you 
don't have to create from scratch, but you still have to type It. The Java API is full of code you 
don't even have to fype. Ail you need to do is learn to use ft. 
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we stJII have a bug 



In our last chapter: we left you 
with the cllf f-hawger A bug. 



How it's supposed to look 

Here's what happens when we 
run it ond enter the numbers 
1,2,3,4,5,6. Lookin good. 

A complete game fhteractloH 

(your mileage may vary) 

I Flla Edit Window Help Srrlle 1 



How the bug looks 

Here's what happens when we 
enter 2,2,2. 



A different game Interaction 

(yikes) 

I Filo EdH Window Help Ffllnl | 



%java SimpleDotComGame 
enter a number 2 
hit 

enter a number 2 
hit 

enter a number 2 
kill 

You took 3 guesses 



Ih the curreHt version, once 
you get a hit you can alwply 
repeat that hit two more 
times for the m\ 



'cjava SimpleDotComGame 
enter a number 1 
miss 

enter a number 2 
miss 

enter a number 3 
miss 

enter a number 4 
hit 

enter a nvimber 5 
hit 

enter a number 6 
kill 

You took 6 guesses 
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\o what happened? 



public String checlcYoiir self (String stringGueas) ( 

int guess = Integer, parseInt(«tringGufiafl) ; Cxmvcri {}^^ Sfa^f^j 
String result = ^^ss"; f *^ ^ ^^^^i^blc U Md iht resoii w/ll 



Ke's where It 
»s wrong. We 
)unted a hit every 
ne the user 
fguessed a cell 
nation, even If 
9f location had 
Mdy been hitf 

need a way to 
kw that when 
a user makes 
hlt» he hasn't 
viously hit that 
I. If he has, then 
don1 want to 
nt It as a hit. 



for (int cell : locationCalls) { 




Jh hit AVY^y. 



) //end if ^^^^'^^UiL 

} II end for 

if (ntnaOfHits = locationCell a . length) { 
result = ^^ki.11"; 

\ II end if 

Syatam. out. println (result) ; <^ 



M/cV« ovi ht l^p^ 
l*^'* i€C WcV^ KOW ^dcAd' 



return result; 

} // end method tKc d^llihj *^Kod. 



Diif lay iK< ^c^ult ^or 
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fixing the bug 

How do we fix it? 

We need a way to know whether a cell has already been hit. Let's run 
through some possibilities, but first, we'll look at whot we know so far... 

We have a virtual row of 7 cells, and a DotCom will occupy three 
consecutive cells somewhere in that row. This virtual row shows a 
botCom placed at cell locations 4,5 and 6. 



The viW„i 



The DotCom has an instance variable— on int array— tKot holds that 
DotCom object's cell locations. 



locationCells 

(instance variable of 
the botCom) 



4^6 

VJ IJ U nM£)^/^ W;^, 



J> ^, and i TL. o( 



# Option one 

We could make a second array, and each t/me the user makes a hit, we 
store that hit in the second array, and then check that array each time 
we get a hit, to sez if that cell has been hit before. 



false ^alse true 

hitails orroT^ ,0 lO lO ■^''^'^i^''2tt.V'\''^^^^^ 
(this would be 0 V T T f^h<^6cl\T,^t^.'^""'^'^-iCo^'^ 



new boolean orray I 1 ! 1 1 iell at index 1 j, l i *^'^'"f'<> U< 

instonce variable of iKe "hitcdl," a^^v! x .5" V- '"'^^ i i« 

the DotCom) ^1 ^^-'^ 
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)pttoii one is too clunky 

Option one seems like more work than you'd expect. It means that each 
1 time the user makes a hft, you have to change the state of the second 

array (the 'hitCefIs' array), oh — but first you have to CHECK the 'hitCells' 
array to see if that cell has already been hit anyway. It would work, but 
there's got to be something better... 



^ Option two 

We could just keep the one original array, but change the volue of any hit 
ceils to -1. That way, we only have ONE array to check and manipulate 



locattonCells 

(instance variable of 
the Dotcom) 



Option two is a little better: but 
still pretty clunky 

Option two IS a (ittle less clunky than option one, but it's not very efficient. You'd 
st/ll have to loop through all three slots (index positions) in the array, even if 
one or more are already invalid because they've been 'hit' (and have a -I value). 
There has to be something better... 
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prep code 
^rep code 




# Option three 



We delete each cell locotion as it gets hit, and then modify the array to 
be smaller. Except arrcc^s con't change their size, so we have to make a 
new array and copy the remaining cells from the old array into the new 
smaller array. 

4 5 6 



locotfoA^ells arr<iy 
BEFORE any cells 
have been hrt 



a site 



locatJonCells array 
AFTER cell '5', which 
was at index 1 in the 
array, has been hit 



Option three would be much better If the array could shrink, so that we wouldn't have 
to make a new smaller array, oopy the remaining values in. and reassign the reference. 



The original prepcode for part of the 
checkYourself 0 method: 



life would be good If only we could 
change It to: 



REPEAT wrth each of the location cells in the int array , 
// COMPARE the user guess to the location cell 
I F the user guess matches 

INCREMENT the number ofhKs 



// FiND OUT if ft was the la^rt location cell: 
IF number of hits (s 3. RETURN "kiir - 



ELSE it was not a kid. so RETURN"hit" 

END IF 

ELSE user guess did not match, so RETURN "miss" 

END IF 
END REPEAT 



// COMPARE the user guess to the location cell 
IF the user guess matches 

► REMOVE this celi from the arT3^ 

// FfNO OUT if it was the last location cell: 

ELSE itwas nota kilLso RETURN'^hrt" 

END IF 

ELSE user guess did not match, so RETURN "miss" 
END IF 
END REPEAT 
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If only I could fnd an array 
that could shrink when you remove 
something. And one that you didn't have 
to loop through to check each element, but 
instead you could just ask Jt If ft cohtoins 
what you're looking for. And it would let you 
get things out of it, without having to know 
exactly which slot the things are in. 
That would be dreamy. But I know it's 



when arrays aren't enough 

Wake up ahd smell the library 



As If by magic, there really Is such a thing. 
But it's not an Brray, it's an ArrayLisL 

A class in the core Java library (the API). 

The Java Standard Edition (which is what you have unless you're work- 
ing on the Micro Edition for small devices and believe me, you'd know) 
ships with hundreds of pre-buiJt classes. Just like our Ready-BaJke code 
except that these built-in dasses are already compiled. 



Thatmeansno typing. 
Just use 'ena. 



■ a 3a 
va lib 



diassdi in 

Vo^* <^ar» use it xti youv toAt 
as i-f you wro-ti it you^l^- 



ditu&lly loob a little xttranjt^ tVia^ tKc 
one ih^yww y^cve- ^ we'll get to t^^e 
real one latev' ih tKe book. Fo*r now, juit 
think Ji it ai an addO method tKat 
takei tKe obje<^t yo<» want t^a add ) 
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Retufi^s true 

Returns eurve 
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Some things you can do with Arrayllst 



Make one 



ArrayList<Egg> myList = new ^^^^yi^ist<Egg> ( ) ; ^ ^ ^^^l^^st ofcy^^ 



Put something in it 

Egg s = new Egg () ; 

myList .add(s) ; 



Put another thing in it 

Egg b = new Egg {) ; 

myList ,add(b) ; 



^ Ui the % "V*-*- 




Hold 



l( ® ^"^^ many things are in it 
^ int theSize = myList . size () ; -^T"^ 4^ si2/< 



Find out if it contains something -a* A^-avl-^ to«bmJ>e ^5 

boolean isin = myList .contains (s) ; *-t+«re»»6«<J »^ 

1 J. • ItAi^a (weans ^i*^ '* '^^ 
Find out where something is (i.e. its index) Ma^Ust « "^^^^^^^d V was 

int icbc = myList. indaxOf(b) ; kT '^^[^l^Xt ll i.aeW)^0 .et-^t 



Find out if it's empty 

boolean empty = myList .isEniptyO ; ^J^^st 



Remove something from it 
myList .remove (s) ; 




Hey look - ii sWarJcj 
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when arrays aren't enough 



Fill in the rest of the table below by looking at the ArrayList code 
on the left and putting in what you think the code might be if It 
were using a regular array instead. We don't expect you to get all 
of them exactly right, so Just make your best guess. 



ArrayUst regular array 



ArrayList<String> myList - new 
ArrayList<String> () ; 








String a = new String ("whoohoo") ; 




myLi3t.add{a) ; 








String b ^ new String (Trog") ; 




myList . add (b) ; 








int theSize = myList .size () ; 








Object 0 = myList .get (1) ; 








myList. remove (1) ; 








Doo±can isin " myijxsL . coiitairiS \D/ ^ 
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Q^-So ArrayUst fs cool, but 
how would I know K exists? 

/\lThe question is really. 
"How do I *:noiv what's [n the 
API?' and that's the key to your 
success as a Java programmer. 
Hot to mention your key to 
leing as lazy as possible while 
still managing to build software. 
You might be amazed at how 
much time you can save when 
somebody else has already done 
fcwst of the heavy lifting, and 
all you have to do is step in and 
create the fun part. 

Sut we digress... the short 
answer Is that you spend some 
time learning whaVs In the core 
APL The long answer is at the 
end of this chapter, where you'll 
learn how to do that. 

But that's a pretty big 
Issue. Not only do I need to 
know that the Java library 
comes with ArrayLlst but more 
Importantly I have to know 
that ArrayList Is the thing that 
can do what I wantl So how 
do I go from a need-to-do- 
something to a-wa/-to-do-lt 
using the API? 




A: 



• Now you're really at the 
heart of it. By the time you've 
finished this book, you'll have 
a good grasp of the language, 
and the rest of your learning 
curve really is about knowing 
how to get from a problem to 
a solution, with you writing the 
teast amount of code. If you can 
be patient for a few more pages, 
we start talking about it at the 
&nd of this chapter. 



Java Bxpostdt 

This v^eek's interview: 
ArrayList, on arrays 

HeadRrst So, Arraylists axe like arrays, right? 

ArrayLlst: In thdr dreamsl / am an object thank you very much. 

HeadFirst: If Tm not nrmtaken, arrays are objects too. They live on the heap right 
there with ali the other objects. 

ArrayList Sure arrays go on the heap^ duh^ but an array is still a wanna-be 
ArrayLisL A poser. Objects have state an^/ behavior, right? We*re dear on that. But 
have you actually tried calling a method on an array? 

HeadFlrsL Now that you mention it, can*t say I have. But what method would I 
call, anyway? I only care about calling methods on the stuff I put w the array, not 
the array itself. And I can use array syntax when I want to put things in and take 
things out of the array. 

ArrayUst: Is that so? You mean to tell me you actually rmmed something from an 
array? (Sheesh^ where do they traxfi you guys? Mqjava's?) 

HeadFirst: Of coxmt I take something out of the array I say Dog d - dogArray[l] 
and I get the Dog objea at index 1 out of the array 

ArrayLlst Aliright, rU try to speal slowly so you can follow along. You were nol^ 
I repeat mi^ removing that Dog from the array All you did was make a copy of the 
reference to the Dag and assign it to another Dog variable, 

HeadFirst Oh, I see what youVe saying. No I didn't actually remove the Dog 
object from the array. It's still there. But I can just set its reference to nuU, I guess. 

ArrayLlst But Pm a first-class object, so I have methods and I can actually, you 
know, do things like remove die Dog*s reference from myself, not just set it to nuU. 
And I can change my size, (fynamicallj (look it up). Just try to get an array to do that! 

HeadFirst Gee, hate to bring this up, but the rumor is that you're nothing more 
than a glorified but less-efficient array That in fact you're just a wrapper for an 
array, adding extra methods for things like resizing that I would have had to write 
myself And while we're at ityymi can't even hoLf primiiioes] Isn't that a big limiiation? 

ArrayList I can't believe you buy into that urban legend. No, I am rwijusi a less- 
efficient array I will admit that there are a few extrerruly rare situations where an 
array might be just a tad, I repeat, tad bit faster for certain things. Bui is it worth the 
mmscuU performance gain to give up all this power. Still, look at all this f^xiMlify. And 
as for the primitives, of cdurse you can put a primtive in an Arraylist, as long as it*3 
v^nrapped in a primitive wrapper class (you'U see a lot more on that in chapter 1 0), 
And as of Java 5.0, that wrapping (and imwrapping when you lake the primitive out 
again) happens automatically. And allright, I'll acknowledge that yes, if you're using an 
ArrayUsi of prinutwes, it probably is faster with an array, because of all the wrapping 
and unwrapping, but still,,, who reaUy uses primitives these days? 

Oh, look at the cimel Pm laU Jbr Pilaies. We'll have to do this again sometime. 
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difference between ArrayList and array 

Comparing ArrayList to a regular array 



ArraylUt 



regular array 



Anravljist<St' rin(T> mvLi^t = new 
ArrayList<String> ( ) ; 


String [] myList = new String[2]; 






String a new String<^^whoohoo") ; 


String a - new String(^^whoohoo") ; 


myList.add(a) ; 


myList[0] = a; 






String b = new StringC'Frog'') ; 


String b = new String ("'Frog'') ; 


myList.add{b) ; 


rayList(l) = b; 






int theSize = myList . size ( ) ; 


int theSize = myList . length; ^TT"^ 








Object 0 = myList.get(l) ; 


String o = myList[l]; 1 






myList . remove (1 ) ; 


myList[l] = null; 








boolean isin = myList . contains (b) ; 


boolean isIn = false; 

for (String item : myList) { 
if (b. equals (item) ) { 
isIn = true; 
break; 

} 

1 



Notice how with ArrayList, you're working 
with an object of type ArrayList, so you're just 
invoking regular old methods on a regular old 
object, using the regular old dot operator 



With an array, you use special array syntax (like 
myList [0] = foo) that you won't use anywhere 
else except with arrays. Even though an 
array iszn object, it lives in its own special 
world and you can*t invoke any methods on 
it, although you can access its one and only 
instance variable, Length. 
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Comparing ArrayUst to a regular array 



A plain old array has to know its 
size at the time It's created. 

But for ArrayList, you just make an object of 
type ArrayList. Every time. It never needs to 
know how big it should be, because it grows 
and shrinks as objects are added or removed. 

new String[2] Heeds a 5*^' 

new ArrayList<String> ( ) 

No size ve<\wred falihoujK you da^ 
jWe ii a Hzt \( you wdJ^t io)- 

To put an object in a regular array, 
you must assign it to a specific 
location. 

(An index from 0 to one less than the length of 
the array.) 

myList [1] = b; 

Meeds at^ wde-K- 

If that index is outside the boundaries of the 
array (Uke, the array was declared with a size of 
2, and now youVe trying to assign something 
to index 3) , it blows up at runtime. 

With ArrayList, you can specify an index us- 
ing the add(anlnt, anObject) method, or you 
can just keep saying add(anObject) and the 
ArrayList will keep growing to make room for 
the new thing. 
myList .add (b) ; 



^ Arrays use array syntax that's not 
used anywhere else in Java. 

But ArrayLists are plain old Java objects, so 
they have no special syntax. 

myList [1] 
A. 

TKea^a7WatkelsC3a.esK.al 
sy^la^ used only ^o. arrays. 



ArrayLists in Java 5.0 are 
parameterized. 

We just said that unlike arrays, ArrayLists 
have no special syntax. But they do use 
something special that was added to Java 5.0 
Tiger — parameterized types. 

ArrayList<String> 

The <S-brin5> in a^jle bvadkeis is d **-fcyfe 
pa^a*v.eW. Ar^ayL\si<ghr\fi^> ,v,eaw s\^f\y "a 
lis-t of Stirihss", as offosed to ^ayUsi<t>c^> 
wKidK means, '*a list of Doy". 

Prior to Java 5.0, there was no way to declare 
the type of things that would go in the 
ArrayList, so to the compiler, all ArrayLists 
were simply heterogenous collections of 
objects. But now, using the <typeGoesHere> 
syntax, we can declare and create an 
ArrayList that knows (and restricts) the 
types of objects it can hold. We 41 look at the 
details of parameterized types in ArrayLists 
in the Collections chapter, so for now, don't 
think too much about the angle bracket <> 
syntax you see when we use ArrayLists. Just 
know that it's a way to force the compiler to 
allow only a specific type of object (the type in 
angle brackets) in the ArrayList. 



the buggy DotCom code 




Ut's fix the Pot Com code. 



Remember, this is how the buggy version looks: 

public class Dotcom ( ^-'^'^'^^^^J^T^ '^^^^^ 



int ( ] locationCells; 
int nuinOfHits = 0; 



public void setLocationCells (int f ] Iocs) ( 
locationCells - Iocs; 

} 



public String checkYourself (String stringGuess) i 
int guess ~ Integer ,parselnt (stringGuess) ; 
String result = "miss"; 



for (int cell : locationCells) { 
'ceTlTT 




brea)c; 



) // ouL; of. the loop 



if (numOfHits == locationCells . length) ( 
result ■= "kill"; 

) 

System. out .println (result) ; 
return result; 

} // elose method 
) // close cla;S3 
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lew and improved PotCom class 

import java . util .ArrayList; ;( ^'t 

public class DocCom { ' 

private ArrayLia t<String> locationCells; 

// private inc nuiTiO£Hit5; '^^^^-v^ Avv List 't)^'^ 

// don'c need thai- nou . ... cJ-^\^a arra^^ to ^^^1 




public void setLocationCells(ArrayLi3t<String> loc) 
locationCeils = loc; 



He* 



td ^^^^ 



public String checkYourself (String userlnput) ( '^''^ 1 l ^^•,^a io»r 




Strang result = "miss"; 

int index = locationCells . indexOf (userlnput) ; 
if (index >= 0) { 



locationCells . remove (index) ; ^ ^ ^Cf^^^ ;£ ^«+'^it?ly 



if (locationCells , isEmpty ( ) ) { 

result - "kill"; 
) else ( 

result "hit"; 
) // close if 

} // close outer if 



return result; 

} // close method 
) // close class 
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making the OotComBust 



Let's build the I^EAL game: 
"Sink a Pot Com" 

We*ve been working on the 'simple* version, but now 
let*s buHd the real one. Instead of a single row, we'll 
use a grid. And instead of one DotCom, we'll u5e 
three. 

Goal: Sink all of the computer's Dot Corns in the 
fewest number of guesses. You're given a rating level 
based on how well you perform. 

Setup: When the game program is launched, the 
computer places three Dot Corns, randomly, on the 
virtual 7x7 grid. When that's complete, the game 
asks for your first guess. 

How you play; We haven't learned to build a GUI 
yet, so this version works at the command-line. The 
computer will prompt you to enter a guess (a cell), 
which you'll type at the command-line (as "A3", "C5", 
etc.). In response to your guess, you'll see a result at 
the command-line, either "hit'*, "nuss", or "You sunk 
Pets.com" (or whatever the lucky Dot Com of the day 
is). When youVe sent all three Dot Corns to that big 
404 in the sky, the game ends by printing out your 
rating. 



c 

D 
E 













































m 




m 














































mm 





You're going to build the 
Sink a Dot Com game, with 
a 7 X 7 grid and three 
Dot Conns. Each Dot Com 
takes up three cells. 



parf of a game liiteractloH 

I Frie Edh Window Hafp sJi 



0 1 2 3 4 5 6 

^ s-t^rts ai like Java arvayi 



%java DotComBust 
Enter a guess A3 
miss 

Enter a guess B2 
miss 

Enter a guess C4 
miss 

Enter a guess D2 
hit 

Enter a guess D3 
bit 

Enter a guess D4 

Ouch! You sunk Pets » com : ( 

kill 

Enter a guess B4 
miss 

Enter a guess 63 
hit 

Enter a guess G4 
hit 

Enter a guess G5 

Ouch? You sunk AskMe.com : ( 
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What needs to change? 

We have three classes that need to change: the 
DotCom class (which is now called DotCom instead of 
SiinpleDotCom)» the game class (DotComBust) and the 
game helper class (which we won*t worry about now) . 

DotCom class 

© Add a name variable 

to hold the name of the DotCom 
(Tets.com", "Go2.com^ etc.) so each Dot- 
Com can print its name when it*s killed (see 
the output screen on the opposite page). 

DotComBust class (the game) 

® Create /fcreeDotComs instead of one. 

® Give each of the three DotComs a name. 

Call a setter method on each DotCom 
instance, so that the DotCom can assign the 
name to its name instance variable. 



get to know the Java API 

DotComBust class continued... 

® Put the DotComs on a grid rather than 
just a single row, and do it for all three 
DotComs. 

This step is now way more complex than 
before, if we*re going to place the DotComs 
randomly. Since we're not here to mess 
with the math, we put the algorithm for 
giving the DotComs a location into the 
GameHelper (Ready-baJke) class. 

© Check each user guess xvUh aE three 
DotComs^ instead of just one. 

© Keep playing the game (i.e accepting 
user guesses and checking them with the 
remaining DotComs) until there are no more 
live DotComs. 

© Get out of main. We kept the simple one in 
main Just to-., keep it simple. But that's not 
what we want for the real game. 



3 Classes: 



5 Objects: 



The game class. 

Makes DotComs, 
gets user Input, 
plays until all Oot- 
Corns are dead 



O 

DotComBust 



DotCom 




The actual 
Dotcom objects. 

Dotcoms know their 
name, location, anrf 
how 10 check a user 
guess for a match. 




DotCom 



The helper class 
(Ready-Bake). 
It knows how to 
accept user com- 
mand-}lne Input, 
and maJte DotCom 
locations. 



G 

GameHelper 



Plus 4 

ArroyLiSts: 1 for 
the DotComBust 
and 1 for each 
of the 3 DotCom 
objects, 
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detailed structure of the game 



Who does what in the PotComl^ust qam 

(ahd when) 




The mainO met^^od 
in the DotComBust 
class instantiates the 
OotComBust object that 
does all the game stuff. 



The DotComBust (gome) 
object instantiates an 
instance of SameHelper, 
the object that will help 
the game do fts work. 



The OotComSust object 
instantiates an ArrayLfSt 
that wrN hold the 3 OotCom 
objects. 



ArrayList object (to 
hold OotCom objects) 
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The botComBust object a£ks the 
helper object for q locotron for a 
DotCom (does this 3 times, one for 
eoch C)otCom) 



OotComBi/st 
object 



The DotComBust object gives each of the bot- 
Corr\ objects a location (which the botComBust 
got from the helper object) like *A2\ "82", 
etc. Each DotCom object puts his own three 
location cells in an ArrayLiSt 



ArrayList object 
(to hold OotCom 
cell loCQtrons) 




ArroyList object to 
hold botCom objects 



DotCom 
objects 



ArrayLiSt 
object 



ArrayList 
object 



The OotiTomBust object asks the helper 
object for a user guess (the helper 
prompts the user and gets input from 
the command-line) 

SameHelper 



The OotComftust object loops through the list 
of DotComs, and asks each one to check the user 
guess for a match. The bottom checks its locations 
ArrayList and returns □ result (^hit", "miss", etc.) 



ArrayList object 
(to hold DotCom 
cell locations) 



OotComSust 
object 

And so the game continues.,, get- 
ting user input, asking each botCom 
to check for o match, and continuing 
until olf bottoms ore dead 




ArrayList object to 
hold DotCom objects 



botCom 
objects 



ArrayList 
object 



ArrayList 
object 
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the OotComBust class (the game) 



I code 




DotComBuit 



GameKfilper helper 
Airaylist dolComsUat 
InlnumOfGueasfts 



selUpGameO 
startPfayingO 

chdckUs^rGuessQ 
fintshC^ameO 



Variable 
Declarations 



Prep code for the real PotComSust class 



The DotComBust class has three main jobs; set up the game, play the game 
until the DotComs are dead, and end the game. Although we could map 
those three jobs directly into three methods, we split the middle job (play the 
game) into two methods, to keep the granularity smaller Smaller methods 
(meaning smaller chunks of fbnctionalicy) help us test, debug, and modify 
the code more easily. 



DECLARE and instantiate the GameHelper instance variable, named helper 

DECLARE and instantiate an AnayUst to hold the list of DotConrvs (initially three) Call it 
dotComsUst 

DECLARE an int variable to hold the number of user guesses (so that we can give the user a 
score at the end of the game). Name it numOfGuesses and set it to 0. 



Method 
Declarations 



DECLARE a setUpCameQ method to create and inrtiaJize the DotCom objects with names 
and locations* Display brief instruaions to the user 

DECLARE a startPiayingO method that asks the player for guesses and calls the 
checkUserGuessQ method until ^1 the DotCom objects are removed from play. 

DECLARE a checkUscrGuessQ nrtethod that loops through all remaining DotCom objects and 
calls each DotCom object's checkYourseifO method- 

DECLARE a finishGameQ method that prints a message about the user's performance, based 
on how many guesses it took to sink all of the DotCom objects. 



Method 

Implementations 



METHOD: ¥Ol<l setUpaam^Q 

II moke three DotCom objects and name them 

CREATE three DotCom objects. 

SET a name for each DotCom, 

ADD the DotComs to the dotCcmsUst ( the ArrayUst). 

REPEAT with each of the DotCom objects in the dotComsUn array 

CALL the pJaceDotComQ method on the helper object, to get a randomly- selected 
location for this DotCom (three cells, vertically or horiiontally aligned, on a 7 X 7 grid). 

SET the location for each DotCom based on the result of the phceOotComQ call, 

END REPEAT 

END METHOD 
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prep coda 




Method ivHpkiMentatlons continued: 

HETHOD; void startPlaylngO 

REPEAT while any DotComs exirt 

GET user input by calling the helper getU^erinputQ naethod 
EVALUATE the user's guess by ch&ckU^rGue^Q method 
END REPEAT 
END METHOD 



METHOD: void checkUserCuw(Strlf^g us^rGuess) 

U find out if tfiere's o hit (and kill) on any DotCom 

INCREMENT the number of user guesses in the numOfGutsses variable 

SET the locaJ resuk variable (a String) to ""miss'^ assuming that the user's guess wiH be a nniss. 

REPEAT wrth each of the DotObjects in the dctComiUst array 

EVALUATE the user's guess by calling the DotCom objea's checkYourseifO method 

SET the result variable to "hrt" or'kill" if appropriate 

IF the result is "kill", REMOVE the DotCom from the dciCcmsUst 

END REPEAT 

DISPLAY the rtsuk value to the user 
END METHOD 



METHOD: void pnhhGameO 

DISPLAY a generic "game over" message, then: 
I F number of user guesses is small. 

DISPLAY a congratulations message 
ELSE 

DISPLAY an insuttlng one 
END IF 
END METHOD 



rpen your pencil 



How should we go from prep code to the 
final code? First we start with test code, ar^d 
then test and build up our methods bit by 
bit. We won't keep showing you test code 
In this book, so now It's up to you to think 



TTiethods. And which nnethod do you test 
and write first? See If you can work out some 
prep code for a set of tests. Prep code or 
even bullet points are good enough for this 
exercise, but if you want to try to write the 



about what you'd need to know to test these real test code {in Java), knock yourself out. 
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the DotComBust code (the game) 







real code ^ 





your pencil 



tiMCode 

yourselft 

Match the 
annotations at tha 
bottom of each paga 
with tho numbora 
In the coda. Writa 
tha numbar In tha 
slot In front off tha 
GorrasiMHidlng 
annotation. 

YouMI uaa aa^ 
annotation Juat onea* 
^u'JI naad all 




import java.util.*; 
public class DotComBust { 

''private GameHelper helper - new GameHelper () ; 

► private ArrayList<DotCom> dotComsList = new ?irrayList<DotCon\> ( ) ; 
/ private int numOf Guesses = 0; 

private void setUpGama () ( 

// first make some dot corns and give them locations 
DotCom one - new DotComO ; 
one .setName ('"Pets .com" ) ; 
DotCom two = new DotCom (); 
two.setName C'eToys .com") ; 
DotCom three = new DotCom () 
three . setName ( "Go2 . com") ; 
dotComsList.add(one) ; 
dotComsList . add (two) ; 
dotComsList . add (three) ; 

System. out .println ("Your goal is to sink three dot corns."); 
System, out. printin ("Pets. com, eToys.com, Go2,com"); 

System.out .printin ("Try to sink them all in the fewest number of guesses"); 

for (DotCom dotComToSet : dotComsList) ( 

ArrayLi3t<String> newLocation - belper.placeDotComO) ; 
dotComToSet , setLocationCells (newLocation) ; 

1 // close for loop 
} // close secUpGame method 

private void startPlaying () ( 

while ( IdotComsList . isEmptyO ) { ^ 

String userGuess = helper , getUserlnput ("Enter a guess"); 
checkUserGuess (userGuess) ; 
) // cl<5se while 
iinishGame () ; 
} // c^iose starcPlaying method 




Yt^tai v-'-ti. eafi^^ VoiCom m {ye list 



'list is UOr emfby 
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real code 



private void checkUserGuess (String userGuess) { 

numOfGuesses++; 
String result = '"miss"; 

for (Dotcom dotComToTest : dotComsList) { 

result = dotComToTest . checkYourself (userGuess) ; 
if (result. equals ("hit") ) { 
break; 

if (result. equals ("kill") ) { 

dotComsList . remove (dotComToTest) ; 
break; 

} 

} // close for 

System. out .println (result) ; 

} // close method 

private void finishGaHie() { 

System.out .println ("All Dot Corns are dead! Your stock is now worthless."); 
if (numOf Guesses 18) { 

System.out .println (''It only took you " + numOfGuesses + " guesses."); 

Sys tern. out. println (" You got out before your options sank."); 
} else { 

System.out .println ("Took you long enough. niomOf Guesses + " guesses 
System. out .println ("Fish are dancing with your options,"); 

} 

} // close method 

public static void main (String [] args) { 
DotComBust game = new DotComBust ( ) ; 
game , setUpGame ( ) ; 
game.startPlayingO ; 

} // close method 
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Whatever you do, 
DON'T turn the 
page! 

Not until you've 
finished this 
exercise. 



Our version is on 
the next page 




_«-efeat all P»tCo«s m the list 



•,^««e«t .-be. jue^ses ihe ^ has .ade 

assume i-t s a wtss , wmless told othevw«se 

ihe 

the otheK •^'-'^m^ the gv,«„; 



-tell ihe game objett 

to set up the yime 



,tCo«. to thedk the useir juess, 
Kit (or kill) 



out o^ the lo^ "sa.^ ^ *ta4 the -fl^*^* ^''f 

^ Create the ja^^c object 
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real code ^ 





import java.util.*; 
public class DotComBust { 



4>c ^^^^ 

private GameHelper helper - new GameHelper ( ) ; 
private ArrayList<DotConi> do 
private int numOfGuesses = 0 



private ArrayList<DotConi> dotComsList = new ArrayList<DotCom> () ; tAB)u ^^^^^ 



private void setUpGameO { 

// first make some dot corns and give them locations 
Dotcom one = new DotComO; 
one .setName T^'Pets .com") ; 
DotCom two - new DotComO; 
two . setName ("eToys , com" ) ; 
DotCom three = new DotComO; 
three, secName (''Go2 .com") ; 
dotComsList . add (one) ; 
dotComsList.add (two) ; 
dotComsList . add (three) ; 



System. out .println ("Your goal is to sink three dot corns."); 
System.out. print la (''Pets . com, eToys-com, Go2 . com") ; 
System. out . println ("Try to sink them all in the fewest number of guesses"); 

for (Dotcom dotComToSet ; dotComsList) { ^ [^^£^4; v^it^i c^tVi DotCo« ■'^ 

ArrayList<String> newLocation = helper. placeDotCom(3) ; 4: ' l)o{C^ \ot^^^ 

dotComToSet . setLocationCells (newLocation) ; ^ — ^ 

I // close for loop frZV vl' 

) II close sQCUpgame method hCipCT-. 

private void startPlaying () ( vi -r i' 

while (! dotComsList. isEmptyO ) 4a*r>€ as (doKo^^sLiitiitwftY^ 

String userGuess = helper .getUser Input ("Enter a guess") ; — ' ^rt i*i<v» i^jpu-t- 
checkUserGuess (userGuess) ; ^.^ 

) // close whiles 

finishGame 0 ; ^ Call ouv- own -f mlih^dme mrthdd. 

) // close StartPlaying mechod 
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private void checkUserGueSS (String userGuess) { 

numOfGuesses++; ^ \r^rtr.trsi tKe nun^bcr of 5uesscs iht user Kas made 

String result = -miss"; 4. assume iVs a miss', unless b>\d otKerWisc 

for (Dotcom dotComToTest : dotComsList) { < . refeai w»tK all PotComs m tKe l»sl 

result ^ dotComToTest .CheckYourself (userGuess) ; ^^^^ "tKe PotCom "to thttk iKc 

4uess, lookmj ^or a W.-t (<Mr kill) 

if (result.equals{"hit") ) { ^ 



9ei oui of tKe loop early, no poi.t 
^ m testing the others ^ 



break; 

} 

if (result. equals ("kill'") ) { 

this i 



dotComsLi 
break 

} 

} // close for 



msList . remove (dotComToTest) ; n ^ "^'^^^ <«*t of the 

l^otComs list theh get out of the loop 



System. out. println (result) ; '^'"'^ "'^^ ^"^^I't for the user ^. , 

} // close method '^'^V ''f^^' ^'"'^9 

user how he did in tKe game 



private void finishGame() { 

System.out .println ('"All Dot Coms are dead! Your stock is now worthless."); 
if (numOf Guesses <= 18) { 

System, out .println (^^It only took you + numOfGuesses + guesses."); 

System. out .println (^^ You got out before your options sank."); 
} else { 

System.out .println ("Took you long enough. ''^+ numOfGuesses + " guesses,"); 
System.out .println (''Fish are dancing with your options"); 
} 

} // close method 



public static void main (String [] args) { 

DotComBust game = new DotComBust ( ) ; ^ " erea-/- i.L 

game . setUpGame ( ) ; . 9^»He object 

game.startPlayingO; > ^" 3^^^ otiez^ 1 . 

^f-p'^yioopt^^^ 
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the DotCom code 





, ; real code ^ 





PotCom class 



import java.util.*; 

public class DotCom { 

private ArrayList<String> locationCells ; 
private String name; 



^ hrr^^Uxsi of tell Uafcons 

- PotCow's name 



public void setLocationCells (ArrayList<String> loc) { 
locationCells = loc; 

} 



A setter f^eihod that updates 

tKe PotCom's t^tior.. 

the ^amcHelf cv fladeD^tCwi - 
method'^ 



public void setName (String n)^4 ^our bas»t setter »netKod 

name = n; 

} The Av^ayList mde>^Of( ) «>ctKod m 

action! I* tKe user ^ ' 
entries m the Arrayt.,*^., - — ^ * 

public String checkYourself (String userlnput) { return its /WrayList wStion- 1+ 

String result = ''^miss"; 

int index = locationCells , indexOf (userlnput) ; 
if (index >= 0) { 

locationCells . remove (index) ; 



The Av^ayList mde>^0+( ) «>cthoa m 
action! If the user auess is one <J the 
entries in the ArrayUt, mde^O^^ 
>,ill return its ArrayUst l<X^ati 
not, mdet^^n Will return -I. 

Usinj A^^ayList's remove( ) me-Uiod to delete an entry. 



if (locationCells . isEmpty {) ) { ^ 
result = ^^kill"; 



Using the isEmf tyf ) method to see if all 
of the locations have been guessed 



System. out. printlnC'Ouch! You sunlc " + name + " : ( ; 
} else { 



result - ''hit"; 
} // close if 
} // close if 
return result; ^^^-^ 

} // close method 
} // close class 



Tell ihe 



when a DotCo. has bee. 



sunk. 
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Super Powerful Boolean fxpresslons 

So far, when we've used boolean expressions for our loops or 
if tests, they've been pretty simple. We will be using more 
powerful boolean expressions in some of the Ready-Bake code 
you're about to see, and even though we know you wouldn't 
peek, we thought this would be a good time to discuss how to 
energize your expressions. 

'And' and 'Or' Operators ( &&, || ) 

Let's say you're writing a chooseCamera( ) method, with lots of rules 
about which camera to select Maybe you can choose cameras 
ranging from $50 to $1 000, but in some cases you want to limit the 
price range more precisely. You want to say something like: 

'If the price range is between $300 and $400 then choose X.' 

if (price >= 300 && price < 400) { 
camera « "X"; 

} 

Let's say that of the ten camera brands available, you have some 
logic that applies to only a few of the list: 

if (brand* equals ("A") || brand.equalsCB") ) { 
//do stuff for only brand A or brand B 

} 

Boolean expressions can get really big and complicated: 

if ((zoomType« equals ("optical") && 

(zoomDegree >= 3 && zoomDegree <= 8)) | | 
(zoomType. equals ("digital") && 
(zoomDegree >= 5 && zoomDegree <= 12))) { 
//do appropriate zoom stuff 

} 

If you want to get really technical, you might wonder about the 
precedence of these operators. Instead of becoming an expert 
in the arcane world of precedence, we recommend that you use 
parentheses to make your code clear. 



Not equals ( != and ! ) 

Let's say that you have a logic like/of the ten available 
camera models, a certain thing is true for all but one" 

if (model 1= 2000) { 

// do non-model 2000 stuff 

} 

or for comparing objects like strings... 
if ( 1 brand. equals ("X")) { 
//do non-brand X stuff 

} 

Short Circuit Operators ( && J| ) 

The operators we've looked at so far, && and ||,are 
known as short circuit operators. In the case of &&, 
the expression will be true only if both sides of the && 
are true. So if the JVM sees that the left side of a && 
expression is false, it stops right there! Doesn't even 
bother to look at the right side. 

Similarly, with ||,the expression will be true \f either side is 
true, so if the JVM sees that the left side is true, it declares 
the entire statement to be true and doesn't bother to 
check the right side. 

Why is this great? Let's say that you have a reference 
variable and you're not sure whether it's been assigned 
to an object. If you try to call a method using this null 
reference variable (i.e. no object has been assigned), you'll 
geta NullPointerException. So, try this: 

if (refVar 1- null && 

refVar.isValidTypeO ) { 
// do 'got a valid type' stuff 

} 

Non Short Circuit Operators ( & J ) 

When used in boolean expressions, the & and | operators 
act like their && and || counterparts, except that 
they force the JVM to always check both sides of the 
expression. Typically, & and | are used in another context, 
for manipulating bits. 
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Ready-bake: GameHelper 




Readj-fcake 
Cdde 



import ^ava.io.*; 
import java.util.*; 

public class Gaiaaflelper { 



This IS the helper doss for the gome. Besides the user input method 
(that prompts the aser and reads input from the commisnd-iine), the 
helper's Big Service is to crecte the cell locations for the DotComs. 
If we were you, we'd just back away slowly from this code, except 
to type it in and compile it. We tried to keep it fairly small to you 
wouldn't have to type so much, but that means it isn't the most 
readable code. And remember, you won't be able to compile the 
botComBust gome class until you have this c\as$. 



private static final String alphabet = ''abcdefg"; 

private int gridLength = 7; 

private int gridSize - 49; 

private int {] grid = new int [gridSize] ; 

private int comCount - 0; 

public String getUserlnput (String prompt) { 
String inputLine = null; 
System, out. print (prompt + 
try { 

Buf feredReader is = new Buf feredReader ( 
new InputStreamReader (System. in) ) ; 
inputLine = is . readLine 0 ; 

if (inputLine . length 0 -= 0 ) return null; 
) catch (lOException e) { 

System. out . println C'lOException: + e) ; 



) 

return inputLine . coLowerCase () ; 



io wai^y* ]i vor]t.\ Thes^ print 
itat^wcnij will 1^ you '^tK^at" 
ty givlf^j yoii i\it ioi^tiork o( tK€ 
DotCop^ij but it will Kcl^ you t«it it- 



} 



public ArrayList<String> placeDotCom (int comSize) { 

ArrayList<String> alphaCells = new ArrayList<String> ( ) ; 



String [1 alphacoords 
String temp = null; 
int [) coords = new intfcomSize 
int attempts = 0; 
boolean success = false; 
int location = 0; 



new String [comSizel; 



// holds 'f6' type coords 
// temporary String for concat 
// current candidate coords 
// current attempts counter 
// flag = found a good location 
// current starting location 



comCount++; 
int incr = 1; 
if ( (comCount % 2) 1) 
incr = gridLength; 

) 



// nth dot com to place 

// set horizontal increment 

// if odd dot com (place vertically) 

// set vertical increment 



while ( [success & attempts++ < 200 ) f 

location = (int) (Math . random ( ) * gridSize) 

//System, ouc. print try " + locatior)) ; 
int X = 0; 

success - true; 

while (success &i x < comSize) { 
if (grid [ location] ~ 0) { 



// main search loop (32) 
// get random starting point 

// nth position in dotcom to place 
// assume success 
// look for adjacent unused spots 
// if not already used 
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Cdde 



^ameffelper class code continued... 



coords [x++] = location; 
location += incr; 
if (location >= gridSize) { 

success - false; 
} 

if (x>0 && (location % gridLength ==0)) { // out of bounds - right edge 



// save location 

// try ''next' adjacent 

// out of bounds - ''bottom' 

// failure 



success = false; 



} 



} else { 

// System, out .print (^^ used -t location) , 
success = false; 

} 



int X = 0; 
int row = 0; 
int column = 0; 

// System, out .println {''\n'') ; 
while (x < comSize) { 
grid [coords [xj ] = 1; 

row = (int) (coords [x] / gridLength); 

column ^ coords [x] % gridLength; 

temp = String. valueOf (alphabet . charAt (column) ) ; 



// failure 

// found already used location 

// failure 

// end while 

// turn location into alpha coords 



// mark master grid pts. as ^used' 

// get row value 

// get numeric column value 

// convert to alpha 



alphaCells , add (temp . concat (Integer , toString (row) ) ) ; 
X++; 

// System. out, print coord ''i-x-h'' ^ " + alphaCells , get (x-l }}; 4^ 



} 



// System, out .println f " \n^^) ; 
return alphaCells; 
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API packages 

Using the Library (the Java API) 

You made it all the way through the DotComBust game, 
thank5 to the help of ArrayUsL And now, as promised, 




To ude a class in the API, you 
have to know which package 
the class Is In. 



Every class in the Java library belongs to a package. 
The package has a name, like javax.SWing (a 
package that holds some of the Swing GUI classes 
you'll learn about soon) . ArrayList is in the package 
called Java.Util, which surprise surprise, holds a 
pile of uHlity classes. You'll learn a lot more about 
packages in chapter 16, including how to put your 
oum classes into your oum packages. For now though, 
we*rejust looking to use some of the classes that come 
with Java. 

Using a class from the API, in your own code, is 
simple. You just treat the class as though you wrote 
it yourself... as though you compiled it, and there it 
sits, waiting for you to use it. With one big difference: 
somewhere in your code you have to indicate the full 
name of the library class you want to use, and that 
means package name + class name. 

Even if you didn't know it, you W aheady been using 
classes from a package. SysiGm (System.out-println), 
String, and Math (Math.randomO), aJl belong to the 

java.lang package. 
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You have to know the full name"^ 
of the class you want to use in 
your code. 

ArrayList is not the /w//name of ArrayList, just as 'Kathy' 
isn't a full name (unless it*s like Madonna or Cher, but we 
won't go there). The full name of ArrayList is actually: 



java . util .ArrayList 




You have to tell Java which ArrayList you 
want to use. You have two options: 



IMPORT 

Put an import statement at the top of your source code file: 
in5>ort java. util. ArrayList ; 
public class MyClass { . . . } 

OR 



Q TYPE 

Type the full name everywhere in your code. Each time 
you use it. Anywhere you use It. 

When you declare and/or instantiate it: 

java. util. ArrayList<Dog> list = new java. util. ArrayList<Dog>() 



When you use It as an argument type: 

public void go (java. util .ArrayList<Dog> list) { } 

When you use it as a return type: 

public java. util. ArrayList<Dog> foo() { . . . } 



Why does there have to 
be a full name? Is that the only 
purpose of a package? 



A: 



Paclcages are important 
for three main reasons. First they 
help the overall organization of a 
project or library. Rather than just 
having one horrendously large 
pile of classes, they're all grouped 
into packages for specific kinds 
of functionality (like GUI, or data 
structures, or database stuff, etc.) 

Second, packages give you a name- 
scoping, to help prevent collisions 
if you and 12 other programmers 
in your company all decide to 
make a class with the same name. 
If you have a class named Set and 
someone else (Including the Java 
API) has a class named Set, you 
need some way to tell the JVM 
which Set class you're trying to use. 

Third, packages provide a level of 
security, because you can restrict 
the code you write so that only 
other classes in the same package 
can access it. You'll learn all about 
that in chapter 16. 



^' OKr back to the na me 
collision thing. How does a full 
name really help? What's to 
prevent two people from giving a 
class the same package name? 



A: 



•Java has a naming convention 
that usually prevents this from 
happening, as long as developers 
adhere to it. We'll get into that in 
more detail in chapter 16. 



''Unless the class is in the java. lang package. 
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when arrays aren't enough 

Whare'd that come from? 

(or, what does it mean when 
a package starts with Javax?) 

In the first and second versions of Java (1.02 
and 1.1), all classes that shipped with Java (in 
other words, the standard library) were In packages 
that began with y<fi^fl. There was alwaysiova./fln^^of course 
— the one you don't have to Import. And there was )ava.net, 
}ovaJo,Java,utU (although there was no such thing as ArrayLlst 
way back then), and a few others, Including the iava.awt 
package that held GUI-related classes. 

Looming on the horizon, though, were other packages not 
included in the standard library. These classes were known as 
Men^\on% and came in two main i\zMors\ standard, and not 
standard. Standard extensions were those that Sun considered 
official, as opposed to experimental, early access, or beta 
packages that might or might not ever see the light of day 

Standard extensions, by convention, all began with an 'x' 
appended to the regular y^ifa package starter. The mother of all 
standard extensions was the Swing library It included several 
packages, all of which began with javax^wing. 

But standard extensions can get promoted to first-class, ships- 
wlth-Java, standard-out-of-the-box library packages. And that's 
what happened to Swing, beginning with version 1 .2 (which 
eventually became the first version dubbed Java 21 

"Cool" everyone thought (Including usj.^Now everyone who has 
Java will have the Swing classes, and we won't have to figure 
out how to get those classes installed with our end-users." 

Trouble was lurking beneath the surface, however, because 
when packages get promoted, well of COURSE they have to 
start with ]ava, not Javax. Everyone KNOWS that packages in 
the standard library don't have that "xT and that only extensions 
have the^x": So, Just (and we mean just) before version 1.2 
went final, Sun changed the package names and deleted the 
"x'lamong other changes). Books were printed and in stores 
featuring Swing code with the new names. Naming conventions 
were intact. All was right with the Java world. 

Except the 20,000 or so screaming developers who realized 
that with that simple name change came disaster! All of their 
Swing-using code had to be changedl The horror! Think of all 
those import statements that started wlthyavax... 

And In the final hour, desperate, as their hopes grew thin, the 
developers convinced Sun to "screw the convention, save our 
code! The rest is history^ So when you see a package in the 
library that begins with /flviur, you know it started life as an 
extension, and then got a promotion. 




Buun poiKTs "^m 

■ Arra/Llsf is a dass In the Java API. 

■ To put something Into an ArrayUst. use addQ. 

■ To remove something from an ArrayLlst use 
ramoveO» 

■ To find out where something is (and If it is) in an 
ArrayUst, use indexO^. 

■ To find out if an ArrayUst is empty, use 
IsEmptyQ. 

■ To get the size (number of elements) in an 
ArrayUst. use the stzeQ method. 

■ To get the length (number of elements) in a 
regular old array remember, you use the length 
variable. 

■ An An^ylist resizes dynamically to what- 
ever size Is needed. It grows when objects 
are added, and it shrinks when objects are 
removed. 

■ You declare the of the array using a type 
parameter, which is a type name in angle 
brackets. Example: AnayUst<8utton> means 
the ArrayUst will be able to hold only objects of 
type Button (or subclasses of Button as you1l 
leam in the next couple of chapters). 

■ Atthough an ArrayUst holds objects and not 
primitives, the compiler virill automatically \vrap' 
(and ^unwrap" when you take it out) a primi- 
tive into an Object, and place that object In the 
ArrayUst instead of the primitive. (More on this 
feature later in the book.) 

■ Classes are grouped into packages. 

■ A dass has a full name, which is a combina- 
tion of the package name and the class name. 
Class AmayUst is really java.utilAn^yUst. 

" To use a class in a package other than java. 
lang, you must tell Java the full name of the 
class. 

■ You use either an Import statement at the top of 
your source code, or you can type the full name 
every place you use the dass in your code. 
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C^I Does import make my 
class bigger? Does It actually 
compile the tmported class or 
package Into my code? 

J^l Perhaps you're a C pro- 
grammer? An import is not the 
same as an include. So the 
answer is no and no. Repeat after 
mei^'an import statement saves 
you from typing, "That's really It. 
You don't have to worry about 
your code becoming bloated or 
slower, from too many Imports. 
An import is simply the way you 
give Java the full nome of a class. 



OK/ how come I never had 
to Import the String class? Or 
System? 

Remember, you get the 
java.lang package sort of "pre- 
Imported" for free. Because 
the classes In Java.lang are so 
fundamental, you don't have to 
use the full name. There Is only 
one javaJang.Strlng class,and one 
Java.iang.System class,and Java 
darn well knows where to find 
them. 



Do I have to put my own 
classes Into packages? How do I 
do that? Car> I do that? 

In the real world (which 
you should try to avoid), yes, you 
wiff want to put your classes into 
packages. We'll get into that in 
detail in chapter \ 6. For now, we 
won't put our code examples in a 
package. 



are red, 
opPles are ripe 

'f)^cfon:tirriort 




One more time, in the unlikely 
event that you don't already 
have this down: 



import 
or 
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''Good to know there's an ArrayList in 
the java.util package. But by myself, how 
would I have figured that out?" 

- JuUa, 31, hand model 



How to play with the API 

Two things you want to know: 

^ What classes are In the library? 

A Once you find a class, how do 
you know what it can do? 




e 



Browse a Book 




IN A NUTSHELL 



A tksiiiop Quick Re/ererice 
O'REILLY" 




Use the HTML API docs 



fitmdvdEiLSLfi 



^, Id r uracd 




javft"^ 2 Ptatfttmi SUadard EdJUon 5U» 
API SpedflcatiAD 

dgcrnvQi H9k API ijcet&ilkM (oi ttc } PMmn SasuUnj Cdit&iq 5jO 







cboci Ok depict tDartunMniEurilcac 
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Browse a Book 



Flipping through a 
reference book is the 
best way to find out 
what's in the Java 
library. Vou can easily 
stumble on a class that 
looks useful, just by 
browsing pages. 




/ana .utU. Currettcy 

{as«LtfflLNumbcff^9rTiMLg^Gurr«flc^^ Cbrrancy.gBOtstanceO 



E>ate 



iLO 



donoobh f&fifidokbh otMpAcabh 



Thus cUis rcprcscnis dales 4Jid limes aixi lets yew work wiih ihetn id a systens-indcpet^ 
deni way. You cin Cfeaic a Dale bv sptofyin^ the number of miQisccondi from ihc 
epoch (midpkifthi GAiT. January iau 1^70) or ihc year, mooth, dair, And, optionally, ihc 
hou/v EniDutc, and second. Years arc spccifictt ai the numbci of years since 1900, If you 
cali the Oat& constiudOf wiih no aj^oracnw. ihc DMe Is initlallzetJ Eo ihc cuitc«i lime 
axid diic. The insuccc methods of the daii allow you lo g« and set ihe various daic 
and hmc ficldi, lo compare date* and limes, and lo conwn dale* to and from Aring 
rcprcscjiu lions. As of Java 11. many of iht dale meihodA l\ave been dcprecaied in 
favor of the methods of ihc Cslondftr daAs. 




DBffilWttiliilliiiiiiii iilijiliii>_ CiiiWiiii Tililll"MliT 

puttie Dat*£l6r^d;3%}: 
I fit^lcDBt*(ifltyear,tm/7icnnjntff»fe): 

r public tn(frtHocN>(V. 
I puUiclr«fMMhiatM(): 

i ptMlctnt 
9 pwbf»6ir< 

I putiiestittcXngfiftiiHi^rincs^ 
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Use the HTML API docs 

Java comes with a fabulous set of online doc5 
called, strangely, the Java API. They're part of 
a larger set called the Java 5 Standard Edition 
Documentation {which> depending on what 
day of the week you look, Sun may be refer- 
ring to as *Java 2 Standard Edition S.O"*), and 
you have to download the docs separately; 
they don't come shrink-wrapped with the Java 
5 download. If you have a high-speed internet 
connection, or tons of patience, you can also 
browse them atjava^sun.cotn. Trust us» you 
probably want these on your hard drive. 

The API docs are the best reference for get- 
ting more details about a class and its methods 
Let s say you were browsing through the refer- 
ence book and found a class called Calendar, 
in java.utiJ, The book tells you a litde about it, 
enough to know that this is indeed what you 
want to use, but you sdll need to know more 
about the methods. 



The reference book> for example, tells you 
what the methods take, as arguments, and what 
they return. Look at ArrayList, for exajnple. 
In the reference book, you*ll find the method 
indexOfO, that we used in the DotCom class. 
But if all you knew is that there is a method 
called indexOfO that takes an object and re- 
turns the index (an int) of that object, you still 
need to know one crucial thing: what happens 
if the object is not in the ArrayList? Looking 
at the method signature alone won't tell you 
how that works. But the API docs will (most of 
the time, anyway). The API docs tell you that 
the indexOfO method returns a -1 if the object 
parameter is not in the ArrayList. That's how 
we knew we could use it both as a way to check 
if an object is even in the ArrayList, and to get 
its index at the same time, if the object was 
there. But without the API docs, we might have 
thought that the indexOf() method would 
blow up if the object wasn't in the ArrayList. 



En C B D 




TSJM 



Mm 

CotecttonH 
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Can you reconstruct the code snippets to make a 
working Java program that produces the output 
listed beiow? NOTE: To do this exercise, you need 
one NEW piece of info — If you iook in the API for 
ArrayList, you'll find a second add method that takes 
two arguments: 

add(lnt Index, Object o) 



a. reni£>ve (2) ; 



It lets you specify to the 
ArrayUst where to put the object you're "adding. 




public static void main (String [] arga) { 



Syst^m.cut .print (element + 




Sys tern. out. println(" 



public class ArrayListMagnet { 



if (a.indexOf ("four") ?= 4) (| 
a.add(4, ^^4,2") ; 




a java ArrayListMagnet 
zero one two three 
zero one three four 
zero one three four 4.2 
2ero one three four 4.2 
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JsmOvm 7.0 



How does this crossword puzzle help you leam 
Java? Well.allofthe words are Java related 
(except or^e red herrir^g). 

Hint; When In doubt remember ArrayList 



Across 

1. 1 can't behave 

6. Or,inthecourtroonn 

7. Where Ifs at baby 
9. A fork's origin 

12. Growan ArrayUst 

13. Wholly massive 

14. Value copy 

16. Not an object 

1 7. An array on steroids 
19. Extent 

21, 19's counterpart 

22. Spanish geek snacks (Note; This has 
nothing to do wfth Java.) 

23. For lazy fingers 

24. Where packages roanr> 




Down 

2. Where the Java action is. 

3. Addressable unit 

4. 2nd smallest 

5. Fractional default 
8. Library's grandest 

10. Mustbelowdenshy 

1 1. He's In there somewhere 

15. Asif 

16. dearth method 

18. What shopping and arrays have in common 

20, Library acronym 

21. What goes around 



More Hints: 



ijazjiaddc qsiupds - EACf moqc ion zz 
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E?fiBicise Solutions 



import java.util.*; 



public class ArrayListMagnet ( 



Fite Edfl Wirrfow Help Oance 


— 1 


I java ArrayListMagnet 




z%to one 


two three 




zero one 


three four 




zero one 


three four 


4.2 


zero one 


three four 


4.2 



1 



public static void main (String [] axgs) { 



1 



ArrayList<Strihg> a = n©w ArrayList<String> () ; 



a. add (0 /'zero") ; 
a, add (1 /'one") ; 



a. add (2 /'two") ; 



a - add (3 /'three") ; 
printAL(a) ; 




public static void printAL (ArrayLiat<String> al) { 
To^ ^Str^i^^lemen^^^l^^^^^^^^^ 



System.out .print (element + ") ; 
) 

Syatem.out .println (^^ '') ; 
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answers 




^pen 



Across 

1. 

6. 

7. 

9. 



your pencil 

Write your OWN set of clues! Look at each word, ar^d try to 
write your own clues. Try making them easier, or harder, or 
more technical than the ones we have. 



12. 

13.. 

14.. 

16.. 

17.. 

19. 

21.. 

22.. 

23.. 

24.. 



Down 

t 

3. 

4. 

5. 

8. 

10. 

n. 

15. 

16. 

18- 

20. 

21. 
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Better Living in 
Objectviiie 



We were underpaid, 
overworked coders 'till we 
tried the Polymorphism Plan. But 
thonks to the Plon, our future is 
bright. Yours con be tool 



Plan your programs with the future in mind, iftherewerea wayto wme 

Java code such that you could take more vacations, how nriuch would it be worth to you? What 
if you could write code that someone else could extend, easily? And if you could write code 
that was flexible, for those pesky last-minute spec changes, would that be something you're 
interested ln?Then this Is your lucky day. forjust three easy payments of 60 minutes time, you 
can have all this. When you get on the Polymorphism Plan, you'll learn the 5 steps to better clas< 
design, the 3 tricks to polymorphism, the 8 ways to make flexible code.and If you act now— a 
bonus lesson on the A tips for exploiting inheritance. Dor^'t delay,an offer this good will give 
you the design freedom and programming flexibility you deserve. It's quick, it's easy, and it's 
available now. Start today, and we'll throw in an extra level of abstraction! 



this is a new chapter 1 Qi 



\ power of inheritance 

Ibair Wars Revisited... 

^^^emember ivay back in chapter 2, when Larry (procedural guy) 
and Brad (00 guy) tuere vytTigfbr the Aerrm chair? Let^s look at 
a few pieces of thai story to review the basics cf inheritance. 

LARRY: YbuVe got duplicated code! The rotate procedure 
fe in all four Shape things. It's a stupid design. You have to 
maintain four different rotate ''methods''. How can that 
ever be good? 

BRABr Oh, I guess you didn't see the final design. Let me 
show you how OO inheritance works, Larry. 




Hooked at what all four 
classes have In oommoH. 

1^ 



o 



TheyVe Shapes, and they all rotate and 
playSound. So 1 abstracted out the 
common features and put them into a 
new class called Shape. 




o 



superclass 



You can read this as. "Square inhdrlto from Shap«", 
"Circie intiarits from Shape", and so on. i ren^oved 
rotataO and playSoundO from the other shapes, so now 
there's oniy one copy to maintain. 

iFi^^hape class Is called the superclass of the other four 
classes. The other four are the subclasses of Shape. The 
subclasses Inherit the methods of the superclass. In other 
words, \Hh^ Shape class has the funciionality, th&n the 
subclasses auiomailcalty get that same functionaHty. 




Then I linked the other 
four shape classes to 
the new Shape class, 
in a relationship called 
Inheritance. 
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What about the Amoeba rotated? 



LARRY: Wasn't that the whole problem here — that the amoeba shape 
had a completely different rotate and playSoimd procedure? 

How can amoeba do something different if it inherits its 
functionality from the Shape class? 

BRAD: That*s the last step. The Amoeba class overrides the 
methods of the Shape class. Then at runtime, the JVM knows 
exactly which rotaU() method to run when someone tells the 
Amoeba to rotate. 




superolau 
(more alwtracf} 



subclasses 
(worespeolflo) 



Shape 



rotateO 
playSoundO 




Amoeba 



rotatflO 

// amoeba-specific 
// rotate code 



playSoundQ 

// amoeba-spedfic 
// sound code 



O 




( wade the Amoeba class override the 
rotateO and playSoundO methods 
of the superclass Shape. Overriding 
Just means that a subclass redefines 
one of its Inherited methods when 
it needs to change or extend the 
ehavlorof that method. 



Overriding methods 





o 

D 



How would you represent a house cat and a tiger, in an 
inheritance struaure. Is a domestic cat a specialized 
version of a tiger? Which would be the subclass and 
which would be the superclass? Or are they both 
subclasses to some othe/- class? 

How would you design an Inheritance structure? What 
methods would be overridden? 

Think about It. Beforeyou turn the page. 
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When you design with inheritance, you put common code in 
a class and then tell other more specific classes that the 
common (more abstract) class is their superclass. When one 
class inherits from another, the subclass inherits from the 
superclass* 

In Java, we say that the subclass extends the raperclass. 

An inheritance relationship means that the subclass inherits 
the members of the superclass. When we say "members of 
a class'' we mean the instance variables and methods. 
For example, if PantherMan is a subclass of SuperHero, the 
PantherMan class automatically inherits the Instance variables 
and methods common to ail superheroes including suit^ 
tights, specialPower, uaeSpecialPower ( ) and 
so on. But the PantherMan subclass can add new 
methods and instance variables of its own, and it can 
override the methods it inherits from the superclass 
SuperHero. 



(more abatraet) 



subclasses 
(more specific) 



SuperH&ro 





iHstaHoe varlabUs 
(state, attributes) 

methods 
(behavior) 



Overriding 
methods 

4^ 



FriedEggMan doesn't need any behavior that's unique, 
so he doesn't override any methods. The methods and 
instance variables in SuperHero are sufficient. 
PantherMan, though, has specific requirements for his suit 
and special powers, so useSpecial Power ( ) and 
putOnSuit ( ) are both overridden in the PantherMan 
class. 

Instance variables are not overridden because they 
don't need to be. They don't define any special behavior, so a 
subciass can give an inherited instance variable any value it 
chooses. PantherMan can set his inherited tights to 
purple, while FriedEggMan sets his to white. 



inheritance and polymorphism 



An Inheritance example: 

public class Doctor { 

boolean worksAtHospital; 

void treatPatient 0 ( 
// perform a checkup 

) 



public class FamilyDoctor extends Doctor { 



boolean makesHouseCalls; 
void giveAdvicaO { 

// give homespun advice 



public class Surgeon extends Doctor { 



void treatPatient () ( 
// perform surgery 



void makelncision () f 

// make incision (yikes!) 

1 




I inherited my 
procedures 5o I didn't 
bother with medrcal school. 
Refax, this won't hurt a bit. 
(now where drd I put thot^ 
power sow..-) 



Doctor 



worksAtHospttal 



tmatPatlent 0 



subclauses 



Surgeon 



Overrides the Inherited 
treatPatientO melhod 

Adds one new method 





OHeihstanee variable 
one method 



treatPatient () 
makelnclsionO 



FaJTillyDoctor 



makesHousdCaits 



giveAdvlce 0 



Adds ofve new 
instance vaHable 

Adds one new rr>6thod 



H^^en your pencil 



How rnany instance variables does 
Surgeon have? 

How many instance variabies does 
FamifyDoctor have? 

How many methods does Doctor have?_ 

How many methods does Surgeon have? , 

How many methods does FamjiyOoctOf 
have? 

Can a FamilyDoctordo treatPatient()? 

Can a FamilyDoctordo makelnclsionO? _ 
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Let's design the inheritance tree for 
an Animal simulation program 

Imagine you're asked to design a simulation program that 
lets the user throw a bunch of different animals into an 
environment to see what happens. We don't have to code the 
thing now, weVe mosdy interested in the design. 

We've been given a list of of the animals that will be 
in the program, but not all. We know that each animal will 
be represented by an object, and that the objects will move 
around in the environment* doing whatever it is that each 
particular type is programmed to do. 

And ive want other programmers to be able to add new 
kinds of animals to the program at any time. 

First we have lo figure out the common, abstract 
characteristics that all animals have, and build those 
characteristics into a class that all animal classes can extend. 




Look for objects that have common 
attributes and behaviors. 

What do these six types hove In 
common? This helps you to abstract 
out behaviors, (step 2) 



How are these types related? This 
helps you to define the inheritance 
tree relationships (step 4-5) 
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Using inheritance to avoid 
duplicating code in subclasses 

We have five instance variables: 

picture the hie name representing the JPEG of this animal 

fi>od - the type of food this animal eats. Right now, there 
can be only tvvo values: meat or grass, 

hunger- an int representing the hunger level of the animal. 
It changes depending on when (and how much) the 
animal eats. 

b&tmd€tries - vzlues representing the height and width of 
the 'space' (for example, 640 x 480) that the animals will 
roam around in. 

location - the X and Y coordinates for where the animal is 
in the space. 

We have four methods: 

makeNoise () - behavior for when the animal is supposed to 
make noise. 

eatO - behavior for when the animal encounters its 
preferred food source, meat or gruss^ 

sieepO - behavior for when the animal is considered asleep. 

roam() - behavior for when the animal is not eating or 
sleeping (probably just wandering around waiting to bump 
into a food source or a boundary) . 



O 



Design a doss that represents 
the common state and behavior. 

Thes« objects arc oil animals, so 
we'll make a common superclass 
called Animal. 

We'll put {n methods and instance 
variables that all animals might 
need. 



picture 

food 

hunger 

boundariss 

location 
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designing for inheritance 



9o all animals eat the same way? 

Assume that we all agree on one thing: the instance 
variables will work for aZ/ Animal types. A lion will 
have his own value for pictxire, food (we're thinking 
meat), hunger, boundaries, and location. A hippo 
will have different valices for his instance variables, 
but he*ll still have the same variables that the other 
Animal types have. Same with dog, tiger, and so on. 
But what about behairior? 

Which iHethods should we override? 

Does a lion make the same noise as a dog? Does 
a cat eat bke a hippo? Maybe in ^^cmrversion, but 
in ours, eating and making noise are Animal-type- 
specific. We can*t figure out how to code those 
methods in such a way that they'd work for any 
animal. OK, that's not true. We could write the 
makeNoiseO method, for example, so that all it does 
is play a sound file defined in an instance variable 
for that type, but that's not very specialized. Some 
animals might make different noises 
for different situations (like one 
for eating, and another when f Tm 
bumping into an enemy, etc.) 



So just as with the Amoeba 
overriding the Shape class rotate () 
method, to get more amoeba-specific (in 
other words, unique) behavior, we'll have 
to do the same for our Animal subclasses. 



Animal 



picture 

food 

hunger 

boundaries 

location 




sleepO 
roamQ 



CJecidc rf a subclass 
needs behavtors (method 
implementations) that are spec\i\c 
to thot particular subclass type. 

Looking ct the Animal class, 
we decide that eotQ and 
makeNoiseO should be overridden 
by the Individual subclasses. 




rean^O tin M 
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Looking for more ihheritance 
opportunities 

The dass hierarchy is starting to shape up. We 
have each subclass override the makeNoiseO and 
eaiO methods, so that there's no mistaking a Dog 
bark from a Cat meow (quite insulting to both 
parties). And a Hippo won't eat like a Lion. 

But perhaps there's more we can do. We have to 
look at the subclasses of Animal, and see if two 
or more can be grouped together in some way, 
and given code that's common to only thai new 
group. Wolf and Dog have similarities. So do 
Lion, Tiger, and Cat. 



O 



Look for more opportunities to use 
abstraction, by finding two or more 
subclasses thai might need common 
behavior. 

We look at our classes and see 
that Wolf and Dog might have some 
behavior in common, and the same goes 
for Lion, Tiger, and Cat. 



Animal 



picture 

food 

hunger 

boundaries 

tocation 



makeM 

miO 
sleapO 
roam() 
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o 



Finish the class hierarchy 

Since animais already hove an organizational 
hierarchy (the whole kingdom, genu5, phylum 
thing), we can use the level that makes the most 
sense for class design. We'll use the biological 
^'families" to organize the animals by making a 
Feline doss and a Canine class. 

We decide that Conines could use a common 
roamO method, because they tend to move in 
[Kicks . We also see that Felines could use a 
common roamO method, because they tend to 
avoid others of their own kind. We'll let Hippo 
continue to use its inherited roamO method— 
the generic one it gets from AnImaL 

So weVe done with the design for now; we*! 
come back to it later In the chapter. 



Animal 



picture 

food 

hunger 

boundaries 

location 
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Which method is called? 

The Wolf class has four methods. One 
inherited from Animal, one inherited from 
Canine (which is actually an overridden 
version of a method in class Animal), and 
two overridden in the Wolf class. When 
you create a Wolf object and assign it to 
a variable, you can use the dot operator 
on that reference variable to invoke all 
four methods. But which version of those 
methods gets called? 



f.akc<^t^Wo\( o\>yti Wolf w = new Wolf(); 

uWs bsc version in VJo\( w . makeNoi se ( ) ; 

u\U b\t version in Canine w . roam ( ) ; 
tA\U the version in 

tails the version in /\t{\fr^\ w . sleep ( ) ; 



When you call a method on an object 
reference, you're calling the most specific 
version of the method for that object type. 

In other words, the Ictwest one wins! 

"Lowest"* meaning lowest on the 
inheritance tree. Canine is lower than 
Animal, and Wolf is lower than Canine, 
so invoking a method on a reference 
to a Wolf object means the JVM starts 
looking first in the Wolf class. If the JVM 
doesn't find a version of the method in 
the Wolf class, it starts walking back up 
the inheritance hierarchy until it finds a 
match. 



Animal 



makeNoiseO 
eatO 
sleepO 
roam() 
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practice designing an inheritance tree 



PesigHihg an Inherltahee Tree 



Class 


Superclasses 


Sobclasses 


Clothing 




BoxerSj Shin 


Boxers 


Clothing 




Shirt 


Clothing 





superclass 
[iHore abAtratt) 



subclasses 
(more ipeelf (e) 



Clothing 



1 



Inharftancd Tabid 



Boxers 



F[jO 




jnherttanca Clfl&s Diagram 



Sharpen your pencil 



Draw an inheritance diagram here. 



Find the relationships that make sense. Fili in the last two columns 



Class 


Superclasses 


Subclasses 


Musician 






Rock Star 






Fan 






Bas5 Player 






Concert Pianist 













Hint: not everything can be connected to something else. 
Hint: you're eltowed to add to or change the de&ses listed. 



You iaid that the JVM starts 
walking up tK« lnhArltanc« tree, 
starting at thA class type you Invoked 
the method on (like the Wolf example 
on the previous page). But what 
happens If the JVM doesn't ever find 
a match? 



Good question! But you don't 
have to worr/ about that. The compiler 
guarantees that a particular method 
fs callable for a specific reference type, 
but it doesn't say (or care) from which 
class that method actually comes from 
at runtime. With the Wolf example, the 
compiler checks for a sleepO method, 
but doesn't care that sleepO Is actually 
defined In (and Inherited from) class 
Animal Remember that If a class 
Inherits a method, It has the method. 



Where the inherited method Is defined 
(In other words. In which superclass 
It Is defined) makes no difference to 
the compiler. But at runtime, the JVM 
will always pick the right one. And 
the right one means, the most specWc 
version for that particular object. 



176 chapter 7 



inheritance and polymorphism 



UsiKg IS-A and HAS-A 

Remember that when one class 
inherits from another^ we say that the 
subclass extends the superclass. When 
you want to know if one thing should 
extend another, apply the IS-A test. 

Triangle IS-A Shape, yeah, that works. 
Cat IS-A Feline, that works too. 
Surgeon IS-A Doctor, still good- 
Tub extends Bathroom^ sounds 
reasonable. 

Until you apply the IS-A UsL 

To know if you Ve designed your types 
correctly, ask, "Does it make sense to 
say type X IS-A type Y?" If it doesn't, 
you know there's something wrong 
with the design; so if we apply the ISA 
test, Tlib ISA Bathroom is definitely 
false. 

What if we reverse it to Bathroom 
extends Tub? That still doesn't work, 
Bathroom ISA TYib doesn't work. 

Tlib and Bathroom ati? related, but 
not through inheritance. Tub and 
Bathroom are joined by a HASA 
relationship- Does it make sense to 
say "Bathroom HASA Tbb**? If yes, 
then it means that Bathroom has a 
Tub instance variable. In other words, 
Bathroom has a rtfermce to a Tub, but 
Bathroom does not extmdl\\h and 
vice-versa. 




Tub bathtub; 
ShktheSiftk: 





Bathroom HASA Tub and Tub HASA Bubbles. 
Bui nobody Inherits from (extends) anybody else- 
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exploiting the power of objects 

Sut wait! There's more! 

The IS-A test works anywhere in the inheriiarice tree. If your 
inheritance tree is weU-designedi the IS-A test should make 
sense when you ask any subclass if it IS-A any of its supertypes. 



If class B extends class A, class B IS-A class A. 

This is true anywhere in the inheritance tree. If 
class C extends class B, class C passes the IS-A 
test for both B and A. 



Canine extends Animal 
Wolf extends Canine 
Wolf extends Animal 

Canine IS-A Animal 
Wolf IS-A Canine 
Wolf IS-A Animal 



Animal 



makeNolseO 
eatO 
sleepO 
roam() 



Canine 



roamO 



Wo(f 



makeNoisaO 
eat() 



With an inheritance tree hke the 
one shown here, you're always 
allowed to say "Wolf extends 
Animal" or "Wolf IS-A Animal". 
It makes no difference if Animal 
is the superclass of the superclass 
of Wolf. In fact, as long as Ajoimal 
is somewhere in the mheritance 
hierarchy above Wolf, Wolf IS-A 
Animal will always be true. 

The structure of the Animal 
inheritance tree says to the world: 

"Wolf IS-A Canine, so Wolf can do 
anything a Canine can do. And 
Wolf IS-A Animal, so Wolf can do 
anything an Animal can do." 

It makes no difference if Wolf 
overrides some of the methods 
in Animal or Canine. As far as 
the world (of other code) is 
concerned, a Wolf can do those 
four methods. How he does them, 
or in which cl^ they're overridden 
makes no difference. A Wolf can 
makeNoise()» eat(), sleepO, and 
roamO because a Wolf extends 
from class Animal. 
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How do you know if you've got 
your inheritance right? 

There's obviousJy more to it than what we*ve 
covered so far, but we'll look at a lot more OO 
issues in the next chapter (where we eventually 
refine and improve on some of the design work 
we did in /Au chapter). 

For now, though, a good guideline is to use the 
IS-A test If "X LS-A Y" makes sense, both classes 
(X and Y) should probably live in the same 
inheritance hierarchy. Chances are, they have 
the same or overlapping behaviors. 

Keep in mind that the 
inheritance IS-A relationship 
works in only one directioni 

Triangle IS-A Shape makes sense> so you can 
have Triangle extend Shape. 

But the reverse — Shape IS-A Triangle — does 
not make sense, so Shape should not extend 
Triangle, Remember that the IS-A relationship 
implies thai if X IS-A Y, then X can do anything 
a Y can do (and possibly more) , 




beer. 



one 



way 



-ness 



of the 



aonsWP 
tnake 



sense. 



one- 
.etnbeti 



SKarpen your pencil 



Put a chedc next to the relationships that 
mal<6 sense. 

□ Oven extendfi Kitchen 

□ Guitar extends Instrument 

□ Person extends Employee 

□ Ferrari extends Engine 

□ FriedEgg extends Food 

□ Beagle extends Pet 

□ Container extends Jar 
n Metal extends Titanium 

□ Gratefui Dead extends Band 

□ Blonde extends Smart 

□ Beverage extends Martini 



Hint apply the IS-A test 
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who inherits what 



So we see how a subcla« gets 
to Inherit a superclass method, but 
what If the superclass wants to use 
the subclass version of the method? 

J\l A superclass won't necessarily 
know about any of its subclasses. 
You might write a class and much 
later someone else comes along and 
extends it. But even if the superclass 
creator does know about (and wants 
to use) a subclass version of a method, 
there's no sort of reverse or backwards 
inheritance, Think about it^children 
inherit from parents, not the other way 
around. 



In a subclass, what if I want to 
use BOTH the superclass version and 
my overriding subclass version of a 
method? In other words, I don't want 
to completely rep/iice the superclass 
version, I Just want to add more stuff 
to It. 

J^'^You can do ihfs! And It's an 
important design feature. Thinkof the 
word"e>ctends"as meaning/'l want 
to exter)d the functionality of the 
superclass'! 
public void roamO { 
super, roam 0 ; 
// my own roam stuff 

} 



You can design your superclass 
methods in such a way that they 
contain method implementations 
that will work for any subclass, even 
though the subclasses may still need 
to 'append' more code. In your subclass 
overriding method, you can call the 
superclass version using the keyword 
super. It's like saying/'first go run The 
superclass version, then come back and 
finish with my own code..." 

inV.e/i^d ^crsio^ of 
sjo^Y ovm subdldss-sYCti+'^t code 



Who gets the Porsche, who gets thc^porcelalM? 
(how to know what a subclass can 
Inherit from Its superclass) 




A subclass inherits members of the 
superclass. Members include instance 
variables and methods, although later in 
tJiis book vve'D look at otJ\er inherited members. A 
superclass can choose whether or not it wants a 
subclaiss to inherit a particuJar member by the level of 
access (Jie particular member is given. 

There are four access levels thai weMJ cover in this book. 
Moving from most restrictive lo least, the four access 
levels are: 



private default protected public 



Access levels control u/ko sees -what, and are crucial 
to having well -designed, robust Java code. For now we'll 
focus just on public and private. The rules are simple for 
those two: 

public members ars Inherited 
private members are not Inherited 

When a subclass inheriis a member, it is as if the 
subclass defined the member itself. In the Shape 
example^ Squsire inherited the rotate ( ) and 
playSoundO methods and to the outside world (other 
code) the Square class simply Im a rotate ( ) and 
playSouj^dO method. 

The members of a class include tJie variables and 
methods defined in U^e class plus anything inherited 
from a superclass. 



Not«' 5rb '««rc ildtails about dc^ault and Y^o{jU^bid in iKafk^v 

1^ ^dtploym^nt) a^d dff^Tvdiit B- 
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Inheritance and polymorphism 



When designing witli inheritance, 
areyoa using or abusing? 

Although some of the reasons behind these rules won't be 
revealed until later in this book, for now, simply knomngz 
few rules will help you build a better inheritance design. 



DO use inheritance when one class is a more specific type 
of a superclass. Example: Willow is a more specific type of 
Tree, so Willow ^^rt^^Tree makes sense. 



DO consider inheritance when you have behavior 
(implemented code) that should be shared among 
multiple classes of the same general type. Example: 
Square, Grcle, and Triangle all need to rotate and play 
sound, so putting that functionality in a superclass Shape 
might make sense, and makes for easier maintenance and 
extensibility. Be aware, however, that while inheritance is 
one of the key features of object-oriented programming, 
it*s not necessarily the best way to achieve behavior reuse. 
It'll get you started, and often it*s the right design choice, 
but design patterns wiU help you see other more subtle 
and flexible options. If you don*t know about design 
patterns, a good follow-on to this book would be Head First 
Design Patterns. 



DO NOT use inheritance just so that you can reuse 
code from another class, if the relationship between the 
superclass and subclass violate either of the above two 
rules. For example, imagine you wrote special printing 
code in the Alarm class and now you need printing code 
in the Piano class, so you have Piano extend Alarm so that 
Piano inherits the printing code. That makes no sensel A 
Piano is noiz more specific type of Alarm. (So the printing 
code should be in a Printer class, that all printable objects 
can take advantage of via a HAS-A relationship.) 



DO NOT use inheritance if the subclass and superclass 
do not pass the IS-A test. Always ask yourself if the subclass 
IS-A more specific type of the superclass. Example: Tea IS- 
A Beverage makes sense. Beverage IS-A Tea does not. 



BULLET POIHTS 




A subclass e)rf©ntfs a superclass. 

A subclass inherits all public instance 
variables and methods of the superclass, but 
does not Inherit the prmte Instance variables 
and methods of the superdass. 

Inherited methods can be ovemdden; instance 
variables camoi be ovenidden (although they 
can be redefined in the subdass, but that's 
not the same thing, and there's almost never a 
need to do ft) 

Use the IS-A test to verify thai your 
inheritance hierarchy is valid, if X extends\, 
ften X IS-A Y must make sense. 

The IS-A relationship worics in only one 
direction. A Hippo is an Animai. but not aii 
Animals are Hippos. 

When a method is overridden in a subciass, 
and that method is Invoked on an instance of 
the subclass, the overridden version of the 
method is called. {The lowest one wins.) 

If class B extends A, and C extends B, class 
B IS-A class A, and class C IS-A class 8, and 
class C also IS-A class A. 
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So what does all this 
iHheritaHce really buy you? 



You get a lot of OO mileage by designing 
with inheritance. You can get rid of duplicate 
code by abstracting out the behavior common 
to a group of classes, and sticking that code 
in a superclass. That way, when you need to 
modify it, you have only one place to update, 
and the change is magically reflected in all the 
classes that inherit that behavior. WeU, there's 
no magic involved, but it is pretty simple; 
make the change and compile the class 
again. That's it. You don't have to touch the 
subclasses! 

Just deliver the nev^-changed superclass, and 
all classes that extend it will automatically use 
the new versioDp 

AJava program is nothing but a pile of classes, 
so the subclasses don't have to be recompiled 
in order to use the new version of the 
superclass. As long as the superclass doesn't 
break anything for the subclass, everything's 
fine. (We'U discuss what the word 'break' 
means in this context, later in the book. For 
now, think of it as modifying something in 
the superclass that the subclass is depending 
on, like a particular method*s arguments or 
return type, or method name, etc.) 



You avoid duplicate 
code. 

Put common code in one place, and let 
the subclasses inherit that code from a 
superclass. When you want to change that 
behavfor, you hove to modify it in only 
one place, and everybody else (i.e. all the 
subclasses) see the change. 

You define a common 
protocol for a group of 

classes. 
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Ihheritahce lets you guarantee that 
all classes grouped under a certain 
supertype have all the methods that 
the supertype has * 

l»i other words, you def the a oommoh protocol for a 
set of classes related through Inherttahce. 

When you define methods in a superclass, that can be 
inherited by subclasses, youVe announcing a kind of 
protocol to other code that says, "All ray subtypes {i.e. 
subclasses) can do these things, with these methods 
that look like this...** 

In other words, you establish a contract 

Class Animal establishes a common protocol for all 
Animal subtypes: 



And remember, when we say any Animal, we mean 
Animal and any class that extends from Animal Which 
again means, any cla^ th^U has Animal soTnewhere abewe it 
in the infieritance hierarchy. 

But we're not even at the really cool part yet, because 
we saved Uie best — polymorphism — for last 

When you define a supertype for a group of classes, 
any subclass of that supertype can be substituted where the 
supertype is expected. 

Say^ what? 

Don't worry, we're nowhere near done explaining it 
Two pages from now, you'll be an expert 




And I care because... 

Because you get to take advantage of 
polymorphism. 



Which matters to me 
because... 

Because you get to refer to a subclass 
object using a reference declared as the 
supertype. 

And that means to me... 

You get to write really flexible code. 
Code that's cleaner (more efficient 
simpler). Code that's not just easier to 
develop, but also much, much easier to 
exfend,in ways you never imagined at 
the time you originally wrote your code. 

That means you can take that tropical 
vacation while your co-workers update 
the program, and your co-workers might 
not even need your source code. 

You'll see how it works on the next page. 

We don't know about you, but 
personally, we find the whole 
tropical vacation thing 
particularly motivating. 



*When we say "all the methods' we mean "all the inherifabie methods", which 
for now actually means, "all the public methods', although later we'll refine that 
<Jefir\ltion a bit more. 
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the way polymorphism works 



The 3 steps of object 
declaration and assignment 



To see how polymorphism 
works, we have to step back 
and look at the way we 
normally declare a reference 
and create an object... 



Dog myDog = new Dog() ; 



o 



Declare a reference 
variable 



Dog myDog ~ new Dog{) ; 

Tells the JVM to allocate space for a 
reference varlable.The reference variable 
iSi forever, of type Dog. In other words, 
a remote control that has buttons to 
control a Dog, but not a Cat or a Button 
or a Socket. 



bog 



Create an object 



Dog myDog = new Dog () ; 

Tells the JVM to allocate space for 
a new Dog object on the garbage 
collectible heap. 



bog object 



o 



Link the object 
and the reference 



Dog myDog = new Dog () ; 

Assigns the nev/ Dog to the refer- 
ence variable nr^yDog. In other words, 
program the remote controL 




Dog object 
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The important point is that the 
reference type AND the object 
type are the same. 




But with poiymorphismy the 
reference and the object can 
be different. 



Animal myDog 
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polymorphism In action 



With polymorphism^ the reference 
type can be a superclass of the 
actual object type. 

When you declare a reference variable, 
any object that passes the IS-A test for the 
declared type of the reference variable 
can be assigned to that reference. In 
other words, anything that extends the 
declared reference variable type can 
be assigned to the reference 
variable. JhU lets you do 
things like make polymorphic 
arrctys. 





. . ,Ur. v.o.<i*> 

OK, OK maybe an example will help. ,^3. ^ <^ tw?^ ^'^^ 

Aniinal[] animals = new Animal [5] ; 



animals [0] - new Dog() ; 

animals [1] = new Cat() ; 

animals [2] = new Wolf () ; 

aniinals 13] = new Hippo () 

animals [4] = new Lion(); 




But look wV^t you get t> do- vfo^ th^ K AKV 



£or (Int 1=0; i < animals . length; ( 



animals [i] .oat () ; 



animals [i] . roamO ; 



you o^ti l>»c Do^'s eatO r^diKod. VVKo. 'i^ U l> you 
jrt Cat'* caiO »«ctWt 
Same WitK voa»0. 
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But wait! There's more! 



You can have polymorphic 
arguments and return types. 

If you can declare a reference variable 
of a supenype, say, Animal, and assign a 
subclass object to it, say, Dog, think of how 
that might work when the reference is an 
argument to a method... 




class Vet { 

public void giveShot (Aniinal a) { 

//do horrible things to the Animal at 
// the other end of the ^a' parameter 
a . makeNoise ( ) ; 

} 



l/e* iJw ' ''9^^^ ^"d 



class PetOtmer { 

public void start 0 { T\,e \/rt^ ^WeSV^otO *«t)s«a take fn^f 

vet V = new Vet() ; A^"^^J.^ ^ ^.^^t a a .ub.V ^ 

Dog d = new Dog(); ^(t^ }^imal, it v/ilU'*-k. 

Hippo h = new Hippo ( ) ; '^^"^ 

V . giveShot <d) ; ^ ^'>^' ^kef^oiteO ^uw 

v.giveShot(h) ; ^ %po's "^ak^^/o«eO 



} 
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siting the power of polymorphism 




NOW I get itl If I write 
my code using polymorphic arguments, 
where I declare the method parameter as a 
superclass type, I cct\ poss in any subclass object at 
runtime, CooL Because that also means I can write my 
code, go on vocation, and someone else can add new 
subclass types to the program and my methods will 
strll work,,, (the only downside is Tm just making life 
easier for that rdiot Jim). 




With polyworphlsw. you caw write code that doesn't 
have to change when you Introduce new subclass 
types Into the program. 

Remember that Vet class? If you write that Vet class using 
arguments declared as type Anwml, your code can handle any 
Animal subclass. That means if others want to take advantage of 
your Vet class, all they have to do is make sure their n^y^ Animal 
types extend class Animal. The Vet methods will still work, even 
though the Vet class was written without any knowledge of the 
new Animal subtypes the Vet will be working on. 




Why is polymorphism guaranteed to work this way? Why is 
It always safe to assume that any subclass type will have the 
methods you think yoii're calling on the superclass type (the 
superclass reference type you're using the dot operator on)? 
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inheritance and polymorphism 



Are there any practical limits 
on the levels of subclassing? How 
deep can you go? 

If you look in the Java API, 
you'll see that most inheritance 
hierarchies are wide but not deep. 
Most are no more than one or two 
levels deep, although there are 
exceptions (especially in the GUI 
classes). You'll come to realize that 
it usually makes more sense to keep 
your inheritance trees shallow, but 
there isn't a hard limit (well, not one 
that you'd ever run into). 

C^! HeyJ just thought of 
something... if you don't have 
access to the source code for a class, 
but you want to change the way a 
method of that class works, could 
you use subclassing to do that? To 
extend the^bad'' class and override 
the method with your own better 
code? 

Yep. That's one cool feature 
of 00, and sometimes it saves you 
from having to rewrite the class 
from scratch, or track down the 
programmer who hid the source code. 



Can you extend any class? Or 
is it like class members where if the 
class is private you can't inherit It... 

There's no such thing as a 
private class, except in a very special 
case called an /nner class, that we 
haven't looked at yet. But there are 
three things that can prevent a class 
from being subclassed. 

The first is access control. Even though 
a class can't be marked private, a 
class can be non-public (what you 
get if you don't declare the class as 
public). A non-public class can be 
subclassed only by classes in the 
same package as the class. Classes in 
a different package won't be able to 
subclass (or even use, for that matter) 
the non-public class. 

The second thing that stops a class 
from being subclassed is the keyword 
modifier final. A final class means 
that it's the end of the inheritance 
line. Nobody, ever, can extend a final 
class. 

The third issue is that if a class has 
only private constructors (we'll 
look at constructors in chapter 9), It 
can't be subclassed. 



Why would you ever want to 
make a final class? What advantage 
would there be In preventing a class 
from being subclassed? 

Typically, you won't make your 
classes final. But if you need security 
— the security of knowing that the 
methods will always work the way 
that you wrote them (because they 
can't be overridden), a final class 
will give you that. A lot of classes in 
the Java API are final for that reason. 
The String class, for example, is final 
because,well, imagine the havoc if 
somebody came along and changed 
the way Strings behave! 

Can you make a mef/iod finals 
without making the whole class 
final? 

If you want to protect a specific 
method from being overridden, mark 
the method with the finalmodifier 
Mark the whole class as final if you 
want to guarantee that none of the 
methods in that class will ever be 
overridden. 
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Keeping the contract; rules for overriding 



When you override a method from a superclass, you're agreeing lo 
fulfill the contract The contract that says, for example, *'I take no 
arguments and I return a boolean." In other words, the arguments 
and return types of your overriding method must look to the outside 
world exactly hke the overridden method in the superclass. 

The methods are the contract 

If polymorphism is going to work, the Toaster's version of the 
overridden method from Appliance has to work at runtime. 
Remember, the compiler looks at the reference type to decide 
whether you can call a particular method on that reference. With 
an Appliance reference to a Toaster, the compiler cares only if class 
Appliance has the method youVe invoking on an Appliance reference. 
But at runtime, the JVM looks not at the reference type (Appliance) but 
at the actual Tb^wi^r object on the heap. So if the compiler has already 
approrued the method call, the only way it can work is if the overriding 
method has the same ai^gimients and return types. Otherwise, 
someone with an Appliance reference ivill call turn On () as a no- 
arg method, even though there's a version in Toaster that takes an 
inL Which one is called at runtime? The one in Appliance. In other 
words, ihe htmOn(int level) method in Tbaster is not an override! 

% Arguments must be the same, and return 
types must be compatible. 

The contract of superclass defines how other code can use a method. 
Whatever the superclass (akes as an argument, the subclass over- 
riding the method must use that same argument. And whatever the 
superclass declares as a return type, the overriding method must de- 
clare either the same type, or a subclass type. Rememfae/', a subclass 
object is guaranteed to be able to do anything its superclass declares, 
so it's safe to return a subclass where the superclass Is expected. 

H The method can't be less accessible. 

That means the access level must be the sanr^e, or friendlier. That 
means you can't, for example, override a public method and make 
ft private. What a shocl< that would be to the code invoking what W 
thinks (at compile time) is a public method, if suddenly at mntime 
the JVM slammed the door shut because the overriding version 
called at runtime is private! 



Appltanca 



boolean tumOnO 
boolean tumOfff) 



aw 



Toafiter 



boolean tumOn( int level ) 



Appliance 



public boolean tumOnO 
public boolean tumOnQ 



So far we've learned about two access levels: private and public. 
The other two are In the deployment chapter (Release your Code) 
and appendix B. There's also another rule about overriding related 
to exception handling, but we'll wait until the chapter on exceptior^s 
(Risky Behavior) to cover that, 
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not a \'?»*^ 







Toaster 



private boolean tumOnO 



inheritance and polymorphism 



Overloading a method 

Method overloading is nothing more than having 
two methods with the same name but different 
argument Hsts. Period. There's no polymorphism 
involved with overloaded methods! 

Overloading lets you make multiple versions 
of a method, with different argument lists, for 
convenience to the callers. For example, if you 
have a method that takes only an int, the calling 
code has to convert, say, a double into an int 
before calling your method. But if you overloaded 
the method with another version that takes a 
double, then you've made things easier for the 
caller. You'll see more of this when we look into 
constructors in the object lifecycle chapter. 

Since an overloading method isn't trying to 
fulfill the polymorphism contract defined by its 
superclass, overloaded methods have much more 
flexibility. 

^ The return types can be 
different. 

You're free to change the return types in 
overloaded methods, as long as the argument lists 
are different. 

0 You can't change ONLY the 
return type. 

If only the retum type is different, it's not a 
valid over/oad— the compiler will assume 
you're trying to override the method. And even 
f/7af won't be legal unless the retum type is 
a subtype of the retum type declared in the 
superclass. To overload a method, you MUST 
change the argument list, although you can 
change the retum type to anything. 

0 You can vary the access 
levels in any direction. 

You're free to overload a method with a method 
that's more restrictive. It doesn't matter, since the 
new method isn't obligated to fulfill the contract of 
the overloaded method. 



An overloaded ne&iod is 
jiist a different method that 
liaj^pens to have flie same 
mefliod name. It has nofldng 
to do wifli iiiieritance and 
polymorphism- An overloaded 
meSiod is NOT ihe same as 
an over i^dden mefliod. 



Legal examples of method 
overloading: 

public class Overloads { 
String uniquelD; 

public int addNums (int a, int b) { 

return a + b; 

} 

public double addNums (double a, double b) { 

return a + b; 

} 

public void setUniquelD (String thelD) { 

// lots of validation code, and then: 
uniquelD = thelD; 

} 

public void setUniquelD (int ssNuinber) { 

String numString = + ssNumber; 
setUniquelD (numString) ; 

} 

} 
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exercise: Mixed Messages 




Mixgd 
Messages 




56 
65 



A short Java program is listed below. One block of 
the program is missing! Your challenge is to match 
the candidate block of code (on the left), wKh the 
output that you'd see if the block were Inserted. 
Not all the lines of output wlil be used, and some of 
the lines of output might be used more than once. 
Draw lines connecting the candidate blocks of 
code with their matching command-line output. 



class A { 

int ivar = 7; 
void ml() { 

System. out. print < "A'S ml^ 

} 

void in2() { 

System. out. print ( "A' s m2, 

} 

void m3() < 

Systejn.out-print ( "A'S m3, 



} 



} 



class B extends A { 
void ml ( ) { 

System. out* print ("B'S ml, 

} 

y 



class C extends B { 
void m3 () { 

System. out-print( "C's m3, ''+(ivar + 6)); 



} 



} 



public class Mixed2 { 

public static void main(Stj:ing [] ctrgs) { 
A a « new A ( ) ; 
B b =^ new B () ; 
C c = new C () ; 



A a2 = new C( ) ; 



candidate code 
(three llhcs) 



code 

candidates: 



b. mlO; 
c ,m2 ( ) ; 
a.m3( ) ; 

c. mK ) ; 
c.m2( ) ; 
C-m3( ) ; 

a. ml ( ) ; 

b. m2( ) ; 
c - m3 () ; 

a2.ml( ) ; 
a2 .m2( ) ; 
a2 .m3( ) ; 



} 
} 
} 
} 



output; 



A'S 


ml , 


A'S 


m2, 


C 


s 


ia3. 


6 


B'S 


ml , 


A'S 


m2. 


A' 


8 


m3. 




A'S 


ml , 


B'S 


m2, 


A' 


S 


m3. 




B'S 


ml. 


A'S 


m2, 


C 


s 


m3, 


13 


B'S 


ml , 


C's 


m2, 


A' 


s 


m3 , 




B'S 


ml. 


A'S 


m2 , 


C 


s 


m3, 


6 


A'S 


ml. 


A'S 


m2, 


C 


s 


m3, 


13 
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BE Com^jfleT 



inheritance and polymorphism 



\^cli of tiie A-B pflirs of metliods listed on ^ rt^. if 
inserted into -flie classes on tiie left, would cong^ile and 
produce Ae outpitt shown? (The A Piefliod inserted into 
class Monster, the B neAod inserted into class VamfireO 



public class MorvsterTestDrive { 

public static void main (String (] args) { 
Monster [ ] ma - new Monster[3]; 
ma[Oj = new Vampire () ; 
ma[l) = new Dragon(); 
ma[2] = new Monster(); 
for(int X = 0; X < 3; x++) { 
ma[x) - frighten (X) ? 

} 

> 

> 

class Monster { 



clasa Vampire extends Monster ( 



o 



class Dragon extends Monster { 
boolean frighten(int degree) ( 

System. out-println( ''breath fire" ) j 
return true; 

} 



boolean frighten (int d) { 

System-out .printlnCarrrgh" ) ; 



return true; 



> 



boolean frighten (int x) { 
Q System. out .println( ''a bite?"); 



return false; 



> 



2 boolean frighten(int x) { 
^ System. out. println( ''arrrgh" 1 ; 



return true; 



> 



int frighten (int f) { 
Q System-out .println ("'a bite?"); 



return 1; 



} 



boolean £righten(int x) { 

System. out .println("arrrgh" ) ; 



return false; 



} 



o 



boolean scare (int x) { 

System. ouit-println( "a bite?''); 



return true; 



} 



boolean frighten (int z) { 

System.out.println("arrrgh" ) ; 



return true; 



} 



boolean f righten(byte b) { 
Q System. out. printlnCa bite?"); 
return true; 



) 
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^ java MonsterTestDrive 
a bite? 
breath fire 
arrrgh 



puzzte: Pool Puzzle 




Pool Puzzle 



Your Job is to take code snippets from the poo! and place thenn into 
the blank lines in the code. You may use the same snippet more 
than once, and you might not need to use all the snippets. Your 
goal is to make a set of classes that will compile and run together 
as a program. Don't be fooled - this one's harder than it looks. 



public class Rowboat 

public rowTheBoatO { 



Syatein. out. print ("'stroke natasha") ; 



} 



public class 



private int 
void 



) < 



length = len; 



} 



public int getiength() { 



} 

public 



move ( ) { 



System » out . print ( 



public class TestBoats { 



inain(String[ ] args){ 



bl = new Boat(); 

Sailboat b2 = new (); 



Rowboat 



= new Rowboat () ; 



b2.setLength(32); 

bl. 0; 

b3. 0; 

.iDove( ) ; 



} 



} 



public class 
public 



System. out . print ( * 



Boat { 



OUTPUT: 



drift drift hoist sail 
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BE Com^fler 



Set 1 will work 



Excise 




Set 2 will not compile because off Vampire's return 
type (int). 

The Vampire's frightenQ method (B) is not a legal 
override OR overioad of Monster's frighten() method. 
Changing ONLY the return type is not enough 
to make a valid overload, and since an int is not 
compatible with a boolean, the method is not a valid 
ovenide. (Remember, ff you change ONLY the return 
type, it must be to a retum type that Is compatible 
with the superclass version's retum type, and then if s 
an overnde. 

Sets 3 and 4 will compile, but produce: 

arrrgh 

breath £xe 

arrrgh 

Remember, dass Vampire did not override class 
Monster's frighten() method. (Die frighten() method 
in Vampire's set 4 takes a byte, not on int,) 



code 

candidates: 

Mixed 
Messages 



b.ml(>; 
c -m2 ( ) ; 
a.m3( ) ; 




a. ml( ) ; 

b. ni2( ) 7 

c. nv3() ; 

a2 -ml ( ) ji 
a2-m2 () ; 
a2.m3( ) ; 



output: 




A's ml, A's m2, C's ni3, 6 

B'a ml, A's ml, A's m3, 

A's ml, B'a m2, A's m3, 

B's ml, A's m2, C's m3 , 13 

B'a ml, C's m2, A's in3, 

B'a ml, A's m2, C's m3, 6 

A's ml, A'S m2, C's m3, 13 
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puzzle answers 



public class Rowboat extends Boat { 

public void rowTheBoat ( ) { 

System. out.print( ''stroke natasha") ; 

} 

} 

public class Boat { 
private int length ; 

public void setLength ( int len ) { 

length = len; 

> 

public int getLength() { 
return length ; 

} 

public void move ( ) { 

System, out. print ("drift 

> 

} 



public class TestBoats { 

public Static void main ( String [ ] args ) { 
Boat bl = new Boat<); 
Sailboat b2 = new Sailboat (); 
Rowboat b3 = new Rowboat ( ) ; 
b2.setLength(32) ; 

bi.nnoveo; 

b3.move( ) ; 
b2 . move ( ) ; 

> 

} 

public class Sailboat extends Boat { 
public void move( ) { 

Sy stem. out, pr int { ''hoist Sail ") ; 

} 



} 

OUTPUT: 



drift drift hoist sail 
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8 interfaces and abstract classes 



Serious Polymorphism 




Inheritance is just the beginning. To exploit polymorphism, we need interfaces 
(and not the GUI kind). We need to go beyond simple inheritance to a level of flexibility and 
extensibility you can get only by designing and coding to interface specifications. Some of the 
coolest parts of Java wouldn't even be possible without interfaces, so even if you don't design 
with them yourself, you still have to use them. But you'll want to design with them. You'll need 
to design with them. You'll wonder how you ever lived without them. What's an interface? It's 
a 1 00% abstract class. What's an abstract class? It's a class that can't be instantiated. What's that 
good for? You'll see in just a few moments. But if you think about the end of the last chapter, 
and how we used polymorphic arguments so that a single Vet method could take Animal 
subclasses of all types, well, that was just scratching the surface. Interfaces are the poly in 
polymorphism. The ab in abstract.The caffeine in Java. 
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designing with inheritance 



I?ld wc forget about sowetblwc) 
when we designed this? 

The class structure isn't too bad. We've designed 
it so that duphcate code is kept to a minimum, 
and we've overridden the methods that we think 
should have subclass-specific implementations. 
We've made it nice and flexible from a 
polymorphic perspective, because we can design 
Animal-using programs with Animal arguments 
(and array declarations), so that any Animal 
subtype — including those we never imagined at the 
time we wrote our code — can be passed in and used 
at runtime. We've put the common protocol for 
all Animals (the four methods that we want the 
world to know all Animals have) in the Animal 
superclass, and we're ready to start making new 
Lions and Tigers and Hippos. 



Animal 



picture 

food 

hunger 

boundaries 

location 



makeNoiseO 
eat() 
sleepO 
roamO 



makeNoiseO 
eat() 





makeNoiseO 
eat() 




Dog 



makeNoiseO 
eat() 
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We know we can say: 

Wolf aWolf = new Wolf(); 



i/Vol-f objcdt Wolf 




These two art the same tyf e. 



And we know we can say: 

Animal aHippo = new Hippo () ; 



Ai^'n^al \re-fev-ejr\de to 
a Hippo object. 




These two av-e NOT the same type- 



But here's where it gets weird: 

Animal anim = new Animal (); 



Ai^imal v-e-fev-eir\de to 
air\ Ai^ii^dl object- 




Animal 



0 



These two a\re the same type, but - 

what the hedk does aY\ AWmal object look like? 
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when objects go bad 



What does a new Animal() object 
look like? 




scary objects 



What are the instance variable values? 

Some classes just should not be 
instantiated! 

It makes sense to create a Wolf object or a Hippo 
object or a Tiger object, but what exactly is an 
Animal object? What shape is it? What color, size, 
number of legs... 

Trying to create an object of type Animal is like a 
nightmare Star Trek™ transporter accident. The 

one where somewhere in the beam-me-up process 
something bad happened to the buffer. 

But how do we deal with this? We need an Animal 
class, for inheritance and polymorphism. But we 
want programmers to instantiate only the less 
abstract subclasses of class Animal, not Animal itself. 
We want Tiger objects and Lion objects, not Animal 
objects. 

Fortunately, there's a simple way to prevent a class 
from ever being instantiated. In other words, to stop 
anyone from saying "new" on that type. By marking 
the class as abstract, the compiler will stop any 
code, anywhere, from ever creating an instance of 
that type. 




You can still use that abstract type as a reference type. 
In fact,that's a big part of why you have that abstract 
class in the first place (to use it as a polymorphic 
argument or return type, or to make a polymorphic 
array) . 

When you're designing your class inheritance 
structure, you have to decide which classes are 
abstract and which are concrete. Concrete classes are 
those that are specific enough to be instantiated. A 
concrete class just means that it's OK to make objects 
of that type. 

Making a class abstract is easy — put the keyword 
abstract before the class declaration: 



abstract class Canine extends Animal { 
public void roam() { } 

} 
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interfaces and polymorphism 



The compiler won't let you Instantiate 
an abstract class 

An abstract class means that nobody can ever make a new 
instance of that class. You can still use that abstract class as a 
declared reference type, for the purpose of polymorphism, but 
you don't have to worry about somebody making objects of that 
type. The compiler guarantees it. 

abstract public class Canine extends Animal 
{ 

public void roam() { } 

} 

public class MakeCanine { alviS^^ 3ss\y^ 

public void go ( ) { ^^.3 Ot, ''^'^'^V^'^^^^S^-- ve^ create, 
Canine c ; ") a svA)6\3S^ 

c = new Dog ( ) ; ) ^ 
c = new Canine ( ) ; ✓ 



} 



File Edit Window Help BeamMeUp 



1 



% j avac MakeCanine . j ava 

MakeCanine . java : 5 : Canine is abstract; 
cannot be instantiated 
c = new Canine ( ) ; 

A 

1 error 



An abstract class has virtually* no use, no value, no 
purpose in life, unless it is extended. 

With an abstract class, the guys doing the work at runtime 
are instances of a subclass of your abstract class. 



Kavc siaht mcmbcvs (sec tKapicv lO). 
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abstract and concrete classes 



Abstract VS. Concrete 

A class that's not abstract is called 
a concrete class. In the Animal 
inheritance tree, if we make 
Animal, Canine, and Feline 
abstract, that leaves Hippo, Wolf, 
Dog, Tiger, Lion, and Cat as the 
concrete subclasses. 

Flip through the Java API and 
you'll find a lot of abstract classes, 
especially in the GUI library. What 
does a GUI Component look 
like? The Component class is the 
superclass of GUI-related classes 
for things like buttons, text areas, 
scrollbars, dialog boxes, you name 
it. You don't make an instance of 
a generic Component and put it on 
the screen, you make a JButton. In 
other words, you instantiate only a 
concrete subclass of Component, but 
never Component itself. 






abstract or concrete? 

How do you know when a class should be 
abstract? Wine is probably abstract. But what 
about Red and Whitel Again probably abstract 
(for some of us, anyway). But at what point in the 
hierarchy do things become concrete? 

Do you make PinotNoir concrete, or is it abstract 
too? It looks like the Camelot Vineyards 1 997 
Pinot Noir is probably concrete no matter what. 
But how do you know for sure? 

Look at the Animal inheritance tree above. Do the 
choices we've made for which classes are abstract 
and which are concrete seem appropriate? 
Would you change anything about the Animal 
inheritance tree (other than adding more Animals, 
of course)? 
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interfaces and polymorphism 



Abstract methods 



Besides classes, you can mark methods abstract, too. An abstract 
class means the class must be extended; an abstract method means 
the method must be overridden. You might decide that some (or all) 
behaviors in an abstract class don't make any sense unless they're 
implemented by a more specific subclass. In other words, you can't 
think of any generic method implementation that could possibly be 
useful for subclasses. What would a generic eat() method look like? 

An abstract method has no body! 

Because you've already decided there isn't any code that would make 
sense in the abstract method, you won't put in a method body. So no 
curly braces — just end the declaration with a semicolon. 

piiblic abstract void eat() ; 



If you declare an abstract method^ you MUST 
mark the class abstract as well. You can't have 
an abstract method in a non-abstract class. 

If you put even a single abstract method in a class, you have to 
make the class abstract. But you can mix both abstract and non- 
abstract methods in the abstract class. 




Dumb Questions 



C^I What is the point of an abstract method? I thought 
the whole point of an abstract class was to have common 
code that could be inherited by subclasses. 

Inheritable method implementations (in other words, 
methods with actual bodies) are A Good Thing to put in a 
superclass. When it makes sense. And in an abstract class, it 
often doesn't make sense, because you can't come up with 
any generic code that subclasses would find useful. The 
point of an abstract method is that even though you haven't 
put in any actual method code, you've still defined part of 
the protocol for a group of subtypes (subclasses). 



Which is good because... 

Polymorphism! Remember, what you want is the 
ability to use a superclass type (often abstract) as a method 
argument, return type, or array type.That way, you get to 
add new subtypes (like a new Animal subclass) to your 
program without having to rewrite (or add) new methods 
to deal with those new types. Imagine how you'd have to 
change the Vet class, if it didn't use Animal as its argument 
type for methods. You'd have to have a separate method 
for every single Animal subclass! One that takes a Lion, one 
that takes a Wolf, one that takes a... you get the idea. So with 
an abstract method, you're saying, "All subtypes of this type 
have THIS method. "for the benefit of polymorphism. 
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you must implement abstract methods 



You MUST iwplewewt all abstract methods 




Implementing an abstract 
method is just like 
overriding a method. 



Abstract methods don't have a body; they exist solely for polymorphism. That 
means the first concrete class in the inheritance tree must implement all abstract 
methods. 

You can, however, pass the buck by being abstract yourself. If both Animal and 
Canine are abstract, for example, and both have abstract methods, class Canine 
does not have to implement the abstract methods from Animal. But as soon as we 
get to the first concrete subclass, like Dog, that subclass must implement all of the 
abstract methods from both Animal and Canine. 

But remember that an abstract class can have both abstract and non-abstract 
methods, so Canine, for example, could implement an abstract method from 
Animal, so that Dog didn't have to. But if Canine says nothing about the abstract 
methods from Animal, Dog has to implement all of Animal's abstract methods. 

When we say "you must implement the abstract method", that means you must 
provide a body. That means you must create a non-abstract method in your class 
with the same method signature (name and arguments) and a return type that is 
compatible with the declared return type of the abstract method. What you put in 
that method is up to you. All Java cares about is that the method is there, in your 
concrete subclass. 
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e^rpen your pencil 



Concrete 

golf course simulatioii 



Abstract vs. Concrete Classes 

Let's put all this abstract rhetoric into some concrete use. In the middle 
column weVe listed some classes. Your job is to imagine applications 
where the listed class might be concrete, and applications where the listed 
class might be abstract. We took a shot at the first few to get you going. 
For example, class Tree would be abstract in a tree nursery program, where 
differences between an Oak and an Aspen matter. But in a golf simulation 
program, Tree might be a concrete class (perhaps a subclass of Obstacle), 
because the program doesn't care about or distinguish between different 
types of trees. (There's no one right answer; it depends on your design.) 



Sample class 



Tree 



Abstract 



tree mmry application 



House 



architect application 



satellite photo application 



Town 



Football Player 



coaching application 



Chair 



Customer 



Sales Order 
Book 



Store 



Supplier 
Golf Club 
Carburetor 



Oven 
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polymorphism examples 

Polymorphism in action 

Let's say that we want to write our own kind of list class, one that will hold 
Dog objects, but pretend for a moment that we don't know about the 
ArrayList class. For the first pass, we'll give it just an add() method. We'll use 
a simple Dog array (Dog [] ) to keep the added Dog objects, and give it a 
length of 5. When we reach the limit of 5 Dog objects, you can still call the 
add() method but it won't do anything. If we're not at the limit, the add() 
method puts the Dog in the array at the next available index position, then 
increments that next available index (nextlndex) . 



MyDogList 

Dog[] dogs 
int nextlndex 

add(Dog d) 



Building our own Dog-specific list 

(Perhaps the world's worst attempt at making our 
own ArrayList kind of class, from scratch.) 



piiblic class MyDogList { 

private Dog [] dogs = new Dog [5] ; 

private int nextlndex = 0 ; < \fi^\\ mtremcw't tWis eatV> 

iwc a f^c^ ^^^^^ 



tKe ao^s a.va7, add t^e P03 



public void add (Dog d) { 

if (nextlndex < dogs. length) { 

dogs [nextlndex] = d; ( av>d ?v-\v>-t a message 

System, out .println (^'Dog added at + nextlndex); 
nextlndex++ ; 

} 



} 



206 chapter 8 



interfaces and polymorphism 



Uh-oK wow wc weed to keep Cats, too. 

We have a few options here: 

1) Make a separate class, MyCatList, to hold Cat objects. Pretty clunky. 

2) Make a single class, DogAndCatList, that keeps two different arrays as instance 
variables and has two different add() methods: addCat(Cat c) and addDog(Dog 
d) . Another clunky solution. 

3) Make heterogeneous AnimalList class, that takes any kind of Animal subclass 
(since we know that if the spec changed to add Cats, sooner or later we'll have 
some otherYmd of animal added as well). We like this option best, so let's change 
our class to make it more generic, to take Animals instead of just Dogs. We've 
highlighted the key changes (the logic is the same, of course, but the type has 
changed from Dog to Animal everywhere in the code. 

Building our own Animal- specific list , ^i, . a 

public class MyAnimalList { ^ L Jt 'brt'C M""^'" 

piiblic void add (Animal a) { n^ova CfM^ vVOLP ^ 
if (nextlndex < animals . length) { (^t^^"^^^^ 
animals [nextlndex] = a; 

System, out .pr in tin (^^ Animal added at + nextlndex); 
nextlndex++ ; 



MyAnimalList 

Animal[] animals 
int nextlndex 

add(Animal a) 



piiblic class AnimalTestDrive{ 

piiblic static void main (String [] args) { 
MyAnimalList list = new MyAnimalList () ; 
Dog a = new Dog() ; 
Cat c = new Cat ( ) ; 
list. add (a) ; 
list. add (c) ; 

} 

} 

rpile Edit Window Help Harm | 



% java AnimalTestDrive 
Animal added at 0 
Animal added at 1 



you are here ► 207 



the ultimate superclass: Object 



What about wowAwlwals? Why wot make 
a class generic enough to take anything ? 

You know where this is heading. We want to change the 
type of the array, along with the add() method argument, to 
something above Animsl. Something even more generic, more 
abstract than Animal. But how can we do it? We don't have a 
superclass for Animal. 

Then again, maybe we do... 

Remember those methods of ArrayList? 
Look how the remove, contains, and 
indexOf method all use an object of type... 
Object! 



ArrayList 



arc «^ar^^/ r^ortJ 



Every class in Java extends 
class Object. 

Class Object is the mother of all classes; it's 
the superclass of everything. 
Even if you take advantage of polymorphism, 
you still have to create a class with methods 
that take and return 3;o?ir polymorphic type. 
Without a common superclass for everything 
in Java, there 'd be no way for the developers 
of Java to create classes with methods that 
could take 3;our custom types... types they never 
knew about when they wrote the ArrayList class. 

So you were making subclasses of class Object 
from the very beginning and you didn't even 1 // rnor6 
know it. Every class you write extends Object, 
without your ever having to say it. But you can 
think of it as though a class you write looks like 
this: 

public class Dog extends Object { } 

But wait a minute. Dog already extends something. Canine. 
That's OK. The compiler will make Canm^ extend Object 
instead. Except Canine extends Animal. No problem, then the 
compiler will just make Amma/ extend Object. 

Any class that doesn't explicitly extend another 
class, implicitly extends Object. 

So, since Dog extends Canine, it doesn't directly extend Object 
(although it does extend it indirectly), and the same is true 
for Canine, but Animal does directly extend Object. 



boolean remove(Obie^^^^^^^^^^^ 

boolean con«'ns(Obi^^^ 

Returns 'true if there s 
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Object 



So wbaf s iw this ultra-supcr-wegaclass Object? 



If you were Java, what behavior would you want every 
object to have? Hmmmm... let's see... how about a 
method that lets you find out if one object is equal 
to another object? What about a method that can 
tell you the actual class type of that object? Maybe a 
method that gives you a hashcode for the object, so 
you can use the object in hash tables (we'll talk about 
Java's hashtables in chapter 17 and appendix B). 
Oh, here's a good one — a method that prints out a 
String message for that object. 



boolean equals() 
Class getClassO 
int hashCodeO 
String toString() 



And what do you know? As if by magic, class Object 
does indeed have methods for those four things. 
That's not all, though, but these are the ones we 
really care about. 



(?) equals(Object o) 

Dog a = new Dog() ; 
Cat c = new Cat() ; 



if (a. equals (c) ) { 

System.out .println (^^true") ; 
} else { 

System.out .println (^^ false") 

} 



YourClassHere 



Evc^y tUss you wv^ite ihhcv^its all the 
methods o-P t\ass 0\>\^tti. The tUs^ts 
youve w^itteh ihhcv^ited methods you 
didh't cvch khow you had. 



0 hashCodeO 



Cat c = new Cat() ; 

Sy s tern . ou t . print In ( c . hashCode ( ) ) 

r 



File Edit Window Help Drop 



1 



% java TestObject 



8202111 



r 



File Edit Window Help Stop 



1 



Pn.ts out a 



java TestObject 



false 



Tells objet-b ave 

toJertA ^c.\ual' (we'll talk 
about wKai 'e«\<*al' ^eall7 
mea«s m ai['\'e*>dix. B)- 



0 toStringO 

Cat c = new Cat() ; 

System. out .println (c . toString 0 ) ; 

^ii^^di^/vindovi^ei^^pselr^^ 



0 getClassO 



Cat c = new Cat() ; 

System . out . println (c . getClass ( ) ) 

I File Edit Window Help Faint I 




% java TestObject 



class Cat 



dass tba-b objet-t was 
•ms-ta*>t«a-ted ^v-om. 



^^^tC.a«>c<>^tV.eaass 
a.d so.e otV^ev .-^ 
vave\>f tave about- 
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fbereiEirejiP 

Dumb Questions 

C^I Is class Object abstract? 

No. Well, not in the formal 
Java sense anyway. Object is a 
non-abstract class because it's 
got method implementation 
code that all classes can inherit 
and use out-of-the-box, without 
having to override the methods. 

C^I Then can you override 
the methods In Object? 

Some of them. But some of 
them are marked final, which 
means you can't override them. 
You're encouraged (strongly) to 
override hashCodeO, equalsO, 
and toStringO in your own 
classes, and you'll learn how to 
do that a little later in the book. 
But some of the methods, like 
getClassO, do things that must 
work in a specific, guaranteed 
way. 

If ArrayLlst methods are 
generic enough to use Object, 
then what does It mean to say 
ArrayLlst<DotCom>? I thought 
I was restricting the ArrayLlst to 
hold only DotCom objects? 

You were restricting it. 
Prior to Java 5.0, ArrayLists 
couldn't be restricted. They 
were all essentially what you 
get in Java 5.0 today if you write 
ArrayList<Object>. In other 
words, an Array List restricted 
to anything thiat's an Object, 
which means any object in Java, 
instantiated from any class type! 
We'll cover the details of this new 
<type> syntax later in the book. 



OK, back to class Object 
being non-abstract (so I guess 
that means It's concrete), HOW 
can you let somebody make an 
Object object? Isn't that just 
as weird as making an Animal 
object? 

Good question! Why is 
it acceptable to make a new 
Object instance? Because 
sometimes you just want a 
generic object to use as, well, as 
an object. A lightweight object. 
By far, the most common use of 
an instance of type Object is for 
thread synchronization (which 
you'll learn about in chapter 15). 
For now, just stick that on the 
back burner and assume that 
you will rarely make objects of 
type Object, even though you 
can. 

So Is It fair to say that the 
main purpose for type Object 
Is so that you can use It for a 
polymorphic argument and 
return type? Like In ArrayLlst? 

The Object class serves 
two main purposes: to act as a 
polymorphic type for methods 
that need to work on any class 
that you or anyone else makes, 
and to provide real method code 
that all objects in Java need at 
runtime (and putting them in 
class Object means all other 
classes inherit them). Some of 
the most important methods in 
Object are related to threads, 
and we'll see those later in the 
book. 



If It's so good to use 
polymorphic types, why 
don't you just make ALL your 
methods take and return type 
Object? 

Ahhhh... think about what 
would happen. For one thing, 
you would defeat the whole 
point of 'type-safety', one 
of Java's greatest protection 
mechanisms for your code. With 
type-safety, Java guarantees that 
you won't ask the wrong object 
to do something you nneantto 
ask of another object type. Like, 
ask a Ferrari (which you think is a 
Toaster) to cook itself. 
But the truth is, you don't have 
to worry about that fiery Ferrari 
scenario, even if you do use 
Object references for everything. 
Because when objects are 
referred to by an Object 
reference type, Java thinks it's 
referring to an instance of type 
Object. And that means the 
only methods you're allowed to 
call on that object are the ones 
declared in class Object! So if 
you were to say: 

Object o = new Ferrari () ; 
o.goFastO ; //Not legal! 

You wouldn't even make it past 
the compiler. 

Because Java is a strongly-typed 
language, the compiler checks 
to make sure that you're calling 
a method on an object that's 
actually capable of responding. 
In other words, you can call a 
method on an object reference 
only if the class of the reference 
type actually has the method. 
We'll cover this in much greater 
detail a little later, so don't worry 
if the picture isn't crystal clear. 
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Using polymorphic references of type Object has a price... 

Before you run off and start using type Object for all your ultra-flexible argument and return 
types, you need to consider a little issue of using type Object as a reference. And keep in mind 
that we're not talking about making instances of type Object; we're talking about making 
instances of some other type, but using a reference of type Object. 

When you put an object into an ArrayList<Dog>, it goes in as a Dog, and comes out as a Dog: 

. Make a« A^^a^Ust dedavea 

ArrayList<Dog> myDogArrayList = new ArrayList<Dog> ( ) ; -to Kold P05 
Dog aDog = new Dog ( ) ; ^ — Make a Po^- 

myDogArrayList . add (aDog) ; ^Add iV>e Po^ to tV>e list p ^^^^^^^^ ^aviaWe. 

Dog d = myDogArrayList . get ( 0 ) ; (^y,;,, ^ -.4, as -tWa^^ ytO «.etV>od declare 0 

t^eWa«seY<»•-«d^'^a7Usl<Poa>.) 

But what happens when you declare it as ArrayList<Object>? If you want to make an ArrayList 
that will literally take any kind of Object, you declare it like this: 

Make ar^ A^vaYUst dctlavcd 

ArrayList<Ob ject> myDogArrayList = new ArrayList<Ob ject> ( ) / ^ ^ V^old ar^^ 'tY\^^ ^^j^^*^' 
Dog aDog = new Dog ( ) ; <:_-Makc a Po^- V.. (These two steps avc tKc same) 

myDogArrayList . add (aDog) / ^ Add tV^c P^S "t^ "^^^ ) 

But what happens when you try to get the Dog object and assign it to a Dog reference? 

Dog d = myDogArrayList. get (0) ; l^^-- '^^'^^'^ ^^'"P''^-- '^^^'^ Y^^ '^'^ A^^ayList<%(tt>, t^>c jctO method 

vctuvns type Object. TKc Compilcv knows only tKat tKc objcdt mlicvits -fvom 
M Object (somcwlicvc m its miicv-itandc tvcc) but it doesn't know it's a PoJ 

Everything comes out of an ArrayList<Object> as a reference of type Object, regardless of what the 
actual object is, or what the reference type was when you added the object to the list 



The objects go IN 
as SoccerBall, 
Fish, Guitar, and 
Car. 




But they come 
OUT as though 
they were of type 
Object. 



ArrayList<Object> 



i i i i 

^j^^ ^j^^ ^^^^ ^j^^ 



Objects come out of 
an ArrayList<Object> 
acting like they're 
generic instances 
of class Object. The 
Compiler cannot 
assume the object 
that comes out is of 
any type other than 
Object. 
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When a Dog loses its Dogness 

When a l?og won't act like a Pog 

The problem with having everything treated 
polymorphically as an Object is that the objects 
appear to lose (but not permanently) their 
true essence. The Dog appears to lose its dogness. 
Let's see what happens when we pass a Dog to 
a method that returns a reference to the same 
Dog object, but declares the return type as type 
Object rather than Dog. 




public void go ( ) { 

Dog aDog = new Dog() ; 

Dog sameDog = getOb ject (aDog) ; 
} \ 



^ <+\,et<"-?'^''' ui"'0V^ctt• 



public Object getObject (Object o) { 

return o ; , • „ , ve-f ever,te to tl^e sa«>e Po^- '^''^^ 



A..a^,Ust<Obje.t> .atV,e. tV,a« a. /^v.av 



TKc (lomp'ilcv docsrv'-t kir^oY/ -that tKc 

•tK'm^ VC'tuvr>cd -f vom tKc mctKod is 

ad-tually a P05, so i-t >wor>''t let you 

assi5r> i-t -to a P05 \-t(trty\U> (Vou II 
sec >wKy or\ "tKc y^c^-t pa^c ) 



DogPolyTest . java : 10 : incompatible types 
found java . lang . Ob ject 

required: Dog 

Dog sameDog = takeObjects (aDog) ; 
1 error ^ 



public void go() { 



This wov-ks (aiihoujh \i r»»ay y>o"t be vcv-y 



© Object sameDog = getObject (aDog) ; <^ a^.^^ ANV'TftlK^ to a »-e^e««de o^ type 

^ Objedt, sihde eveiry diass passes the |S-A test 

■foir Objedt- Evemy objedt in Java is an instande 
public Object getObject (Object o) { ^ 1^^^ Objedt, bedause evevy dIass in Java has 



^^^^^"^ ° ' Objedt at the top o^ its inhevitande tvee. 



} 
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Objects doh't bark. 



So now we know that when an object is 
referenced by a variable declared as type 
Object, it can't be assigned to a variable 
declared with the actual object's type. 
And we know that this can happen when 
a return type or argument is declared 
as type Object, as would be the case, 
for example, when the object is put 
into an ArrayList of type Object using 
ArrayList<Object>. But what are the 
implications of this? Is it a problem to 
have to use an Object reference variable 
to refer to a Dog object? Let's try to call 
Dog methods on our Dog-That-Compiler- 
Thinks-Is-An-Obj ect: 





W\\tv\ you gci a)r\ objcd-t rc-f c\rc)r\^c -from 
I ar\ A^v-ayLis-t<Objcd't> (or ay\y method 
\ ihat dcdarcs Objcdt as ihc v-c-turr\ iype), 
it toinsts badk as a polyrv^orphid rc-f cv-Chdc ' 
type o-f Object. So you have ar\ Object 
v-c^cmjdc to (m this dasc) a D05 iy\stay\dg. 



Object o = al. get ( index) ; 
int i = o . hashCode ( ) ; ^ — 
o . bark ( ) ; 



^'tr S■-tv^^:;rcS^^^-='• 



Ca^'t do this'' The Objcdt diass has r\o idea what 

it mcar\s to bavkO. Ever\ though VOU kr\ow it's 

vcally a Dog at that \Y\dt%, the dompilcv doesn't-. 



The compiler decides whether 
you can call a method based 
on the reference type, not the 
actual object type. 



Even if you know the object is capable 
("...but it really is a Dog, honest..."), the 
compiler sees it only as a generic Object. 
For all the compiler knows, you put a 
Button object out there. Or a Microwave 
object. Or some other thing that really 
doesn't know how to bark. 
The compiler checks the class of the 
reference type — not the object type — to 
see if you can call a method using that 
reference. 




Object 



equalsQ 
getClassO 
hashCodeQ 
toStringO 





The method youVc dallmj or\ a 
Yt^trtr^tt MUST be i^ the diass 
that v-e-f ev-eir^de tyf e- Poesir^'t rwatte\r 
what the actual object is. 



o . hashCode ( ) ; 

The V \'t^crty\U was dtdartd as type 
Object so you t^r\ ts\\ methods o^ly i-f 
those methods a\re \r\ diass Object. 
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objects are Objects 



He treats me like an 
Object. But I can do so 
much more.. .if only he'd see 
me for what I really am. 



5= 



Object 



equalsQ 
getClassO 
hashCodeQ 
toStringO 



Snowboard 



equalsQ 
getClassO / 
hashCodeQ / 
toStringO J 

turnO 
shredQ 
getAirO 
loseControlO 



^ct m touch with your Imzr Object. 

An object contains everything it inherits from each of its 
superclasses. That means every object — regardless of its 
actual class type — is also an instance of class Object. That 
means any object in Java can be treated not just as a Dog, 
Button, or Snowboard, but also as an Object. When you 
say new Snowboard ( ) , you get a single object on the 
heap — a Snowboard object — but that Snowboard wraps 
itself around an inner core representing the Object 
(capital "O") portion of itself. 



oir\ -the heap 



Snowboard 'mhcv-i-b methods 
-frorv^ supc\rdlass Objcdt, ar\d 
adds -four nsorc- 




There is ohiy ONE objcdt oy\ the heap here. A Snowboard 
objedt Bu-t it to}r\{^\Y\s both the Snowboard diass parts of 
itsel-f ay\d the Objedt diass parts of itsel-f . 
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^Polymorphism' means 
^many forms'. 

You can treat a Snowboard as a 
Snowboard or as an Object. 

If a reference is like a remote control, the 
remote control takes on more and more buttons 
as you move down the inheritance tree. A 
remote control (reference) of type Object has 
only a few buttons — the buttons for the exposed 
methods of class Object. But a remote control 
of type Snowboard includes all the buttons from 
class Object, plus any new buttons (for new 
methods) of class Snowboard. The more specific 
the class, the more buttons it may have. 

Of course that's not always true; a subclass might 
not add any new methods, but simply override 
the methods of its superclass. The key point is 
that even if the object is of type Snowboard, an 
Object reference to the Snowboard object can't see 
the Snowboard-specific methods. 



Snowboard S_= new Snowboard 
Object O = s 



When you put 
an object in an 
ArrayList<Object>, you 
can treat it only as an 
Object, regardless of 
the type it was when 
you put it in. 

When you get a 
reference from an 
ArrayList<Object>, the 
reference is always of 
type Object, 

That means you get an 
Object remote control. 




The snowboard rcmo-tc CoyAxo 
(Yt^tYt^tt) has move bu-tiohS \)r\B^ 
ar\ Objcdt rcrv^otc toY\{xoV T\\t 
Snowboard rcrv^otc dar\ sec the -full 
ShowboardhCss -the Sy\oy/boav"d 
objcdt It ^ar\ addcss all -the methods 
m S)r\oy/boav-d, mdlud'mj both the 
mhcritcd Objcdt methods ay\d the 
methods -from diass Snowboard. 



The Object re-f e\rer\de dar\ se e or^ly the 
Objedt parts of the Snowboard objedt- 
It ^ar\ addess or\ly the methods of diass 
Objedt. It has -fewer buttons thar\ the 
Snowboard remote do^trol 
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casting objects 




Casi the so^taWtd 'Oh^cti' (but 
wc khow he s ati\Aa\\y a Pog) to 
■type so -that you (la^ -tv-cat 
hir»» like the P03 he v-eally is. 



Casting an object reference 
back to its real type. 




Object 



It's really still a Dog but if you want to call 
Dog-specific methods, you need a reference declared 
as type Dog. If you're sure"^ the object is really a 
Dog, you can make a new Dog reference to it by 
copying the Object reference, and forcing that 
copy to go into a Dog reference variable, using a 
cast (Dog) . You can use the new reference to 
call i^og- methods. 



Object o = al.get(xndex) ; ^y^. ^tbatk 

,tastwfo) ^^^^^^ 



Dogd= (Dog) o;^tast , 
d.roamO ; 




*If you're not sure it's a Dog, you can use the 
instanceof operator to check. Because if 
you're wrong when you do the cast, you'll get a 
ClassCastException at runtime and come to a 
grinding halt. 

if (o instanceof Dog) { 
Dog d = (Dog) o; 

} 
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So now you've seen how much Java 
cares about the methods in the 
class of the refe renc e variable. 

You can call a method on an object only if 
the class of the reference variable has that 
method. 

Think of the public methods in your class as 
your contract, your promise to the outside 
world about the things you can do. 



When you write a class, you almost always expose some 
of the methods to code outside the class. To expose a 
method means you make a method accessible, usually by 
marking it public. 

Imagine this scenario: you're writing code for a small 
business accounting program. A custom application 
for "Simon's Surf Shop". The good re- 
user that you are, you found an Account 
class that appears to meet your needs 
perfectly, according to its documentation, 
anyway. Each account instance represents 
an individual customer's account with the 
store. So there you are minding your own 
business invoking the credit( ) and debit( ) 



Account 



debit(double amt) 
credit(double amt) 
double getBalanceO 



methods on an account object when you realize you 
need to get a balance on an account. No problem — 
there's a getBalance() method that should do nicely. 

Except... when you invoke the getBalance() method, 
the whole thing blows up at runtime. Forget the 
documentation, the class does not have that method. 
Yikes! 

But that won't happen to you, because everytime you 
use the dot operator on a reference (a.doStuff()), the 
compiler looks at the reference type (the type 'a' was 
declared to be) and checks that class to guarantee the 
class has the method, and that the method does indeed 
take the argument you're passing and return the kind of 
value you're expecting to get back. 

Just remember that the compiler checks the class of the 
reference variable, not the class of the actual object at the 
other end of the reference. 
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modifying a class tree 



What if you weed to change 
the contract? 

OK, pretend you're a Dog. Your Dog class 
isn't the only contract that defines who you 
are. Remember, you inherit accessible (which 
usually means public) methods from all of 
your superclasses. 

True, your Dog class defines a contract. 

But not all of your contract. 

Everything in class Canine is part of your 
contract. 

Everything in class Animal is part of your 
contract. 

Everything in class Object is part of your 
contract. 

According to the IS-A test, you are each of 
those things — Canine, Animal, and Object. 

But what if the person who designed your 
class had in mind the Animal simulation 
program, and now he wants to use you (class 
Dog) for a Science Fair Tutorial on Animal 
objects. 

That's OK, you're probably reusable for that. 

But what if later he wants to use you for a 
PetShop program? You don Y have any Pet 
behaviors. A Pet needs methods like beFriendlyO 
and play(). 

OK, now pretend you're the Dog class 
programmer. No problem, right? Just add 
some more methods to the Dog class. You 
won't be breaking anyone else's code by 
adding methods, since you aren't touching 
the ^xz-s^mg- methods that someone else's code 
might be calling on Dog objects. 

Can you see any drawbacks to that approach 
(adding Pet methods to the Dog class)? 



Think about what YOU would do if YOU were 
the Dog class programmer and needed to 
modify the Dog so that it could do Pet things, 
too. We know that simply adding new Pet be- 
haviors (methods) to the Dog class will work, 
and won't break anyone else's code. 

But... this is a PetShop program. It has more 
than just Dogs! And what if someone wants 
to use your Dog class for a program that has 
wild Dogs? What do you think your options 
might be, and without worrying about how 
Java handles things, just try to imagine how 
you'd like to solve the problem of modifying 
some of your Animal classes to include Pet 
behaviors. 

Stop right now and think about it, 

before you look at the next page where we 

begin to reveal everything. 

(thus rendering the whole exercise completely useless, robbing 
you of your One Big Chance to burn some brain calories) 
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lefs explore some design options 
for reusing some of our existing 
classes in a PetShop program. 

On the next few pages, we're going to walk through 
some possibihties. We're not yet worried about 
whether Java can actually <io what we come up with. 
We'll cross that bridge once we have a good idea of 
some of the tradeoffs. 



0 Option one 

We take the easy path, and put pet 
methods in class Animal. 

Pros; 

All the Animals will instantly inherit 
the pet behaviors. We won't have to 
touch the existing Animal subclasses 
at all, and any Animal subclasses 
created in the future will also get to 
take advantage of inheriting those 
methods. That way, class Animal can 
be used as the polymorphic type in 
any program that wants to treat the 
Animals as pets 

Cohs: 

So... when was the last time you 
saw a Hippo at a pet shop? Lion? 
Wolf? Could be dangerous to give 
non-pets pet methods. 

Also, we almost certainly WILL 
have to touch the pet classes 
like Dog and Cat, because (in 
our house, anyway) Dogs 
and Cats tend to imple- 
ment pet behaviors 
VERY differently. 
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@ Option two 

We start with Option One, putting the pet methods 
in class Animal, but we make the methods abstract, 
forcing the Animal subclasses to override them. 

Pros; 

That would give us all the benefits of Option One, but with- 
out the drawback of having non-pet Animals running around 
with pet methods (like beFriendlyO). All Animal classes 
would have the method (because it's in class Animal), but 
because it's abstract the non-pet Animal classes won't 
inherit any functionality. All classes MUST override the 
methods, but they can make the methods "do-nothings". 



Cohs: 

Because the pet methods in the Animal class are all 
abstract, the concrete Animal subclasses are forced to 
implement all of them. (Remember, all abstract methods 
MUST be implemented by the first concrete subclass 
down the inheritance tree.) What a waste of time! 
You have to sit there and type in each and every 
pet method into each and every concrete non- 
pet class, and all future subclasses as well. 
And while this does solve the problem of 
non-pets actually DOING pet things 
(as they would if they inherited pet 
functionality from class Animal), the 
contract is bad. Every non-pel: 
class would be announcing to the 
world that it, too, has those 
pet methods, even though 
the methods wouldn't 
actually DO anything 
when called. 

This approach doesn't 
look good at all. It just 
seems wrong to stuff 
everything into class Animal 
that more than one Animal type 
might need, UNLESS it applies to 
ALL Animal subclasses. 



Animal 
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® Option three 

Put the pet methods ONLY in the 
classes where they belong. 

Pros; 

No more worries about Hippos greeting you at the 
door or licking your face. The methods are where 
they belong, and ONLY where they belong. Dogs can 
implement the methods and Cats can implement the 
methods, but nobody else has to know about them. 

Cohs: 

Two Big Problems with this approach. First off, you'd 
have to agree to a protocol, and all programmers of 
pet Animal classes now and in the future would have 
to KNOW about the protocol. By protocol, we mean 
the exact methods that we've decided all pets should 
have. The pet contract without anything to back it up. 
But what if one of the programmers gets it just a tiny 
bit wrong? Like, a method takes a String when it was 
supposed to take an int? Or they named it c/oFriendly() 
instead of bePriendlyO? Since it isn't in a contract, 
the compiler has no way to check you to see if you've 
implemented the methods correctly. Someone 
could easily come along to use the pet Animal 
classes and find that not all of them work 
quite right. 

And second, you don't get to use 
polymorphism for the pet methods. 
Every class that needs to use 
pet behaviors would have to 
know about each and every 
class! In other words, 
you can't use Animal 
as the polymorphic 
type now, because the 
compiler won't let you call 
a Pet method on an Animal 
reference (even if it's really a 
Dog object) because class Animal 
doesn't have the method. 



, etv^ods oHuV -^^^ 
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So what we REALLY need is: 

* Away to have pet behavior in just the pet classes 

* A way to guarantee that all pet classes have all of the same 
methods defined (same name, same arguments, same return 
types, no missing methods, etc.), without having to cross your 
fingers and hope all the programmers get it right. 

* Away to take advantage of polymorphism so that all pets can have 
their pet methods called, without having to use arguments, return 
types, and arrays for each and every pet class. 



It looks like we need TWO^ 
superclasses at the top 



,„..t<^ \ -i-V 



Pet 



Animal 




222 chapter 8 



interfaces and polymorphism 



There's just one problem with the "two superclasses" approach... 



It's called '^multiple inheritance" 
and it can be a Really Bad Thing. 

That is, if it were possible to do in Java. 

But it isn't, because multiple inheritance has a problem 
known as The Deadly Diamond of Death. 



Deadly Diamond of Death 



)v 

aWe- 



DigitalRecorder 



int i 



burn() 




CDBurner 




DVDBurner L 






burnQ 




burnQ 1 





A language that allows the Deadly Diamond of Death can lead to 
some ugly complexities, because you have to have special rules to 
deal with the potential ambiguities. And extra rules means extra 
work for you both in learning those rules and watching out for 
those "special cases". Java is supposed to be simple, with consistent 
rules that don't blow up under some scenarios. So Java (unlike 
C++) protects you from having to think about the Deadly Dia- 
mond of Death. But that brings us back to the original problem! 
How do we handle the Animal/Pet thing? 
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Interface to the rescue! 

Java gives you a solution. An interface. Not a Gt// interface, not the generic 
use of the word interface as in, "That's the pubhc interface for the Button 
class API," but the Java keyword interface. 

A Java interface solves your multiple inheritance problem by giving you 
much of the polymorphic benefits of multiple inheritance without the pain 
and suffering from the Deadly Diamond of Death (DDD). 

The way in which interfaces side-step the DDD is surprisingly simple: make 
all the methods abstract! That way, the subclass must implement the methods 
(remember, abstract methods musthe implemented by the first concrete 
subclass), so at runtime the JVM isn't confused about which of the two 
inherited versions it's supposed to call. 



Pet 



abstract void beFriendlyO; 
abstract void playQ; 



A Java interface is like a 
100% pure abstract class. 

abstract, ^''Y.LU-o^trMt) 



To DEFINE an interface: 

piiblic interface Pet { . . . } 

\ 



To IMPLEMENT an interface: 



public class Dog extends Canine implements Pet { . 
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MaiclHg ahd ImplemeHtiHg 
the Pet iwtcrf acc 

\ 

public interface Pet { 

public abstract void 
public abstract void 



beFriendlyO ; 
playO ; 




• I % L 



public class Dog extends Canine implements Pet { 



VovA sa 



public void beFriendlyO {. 
public void playO { . . } 



^ you , o . 



public void roam() { . . . } 



public void eat() { . . . } ^ 



These a^ejus-t .o^^^/ 
methods. 



fhereiEirejiP 

Dumb Questions 

Walt a minute. Interfaces don't 
really give you multiple Inheritance, 
because you can't put any 
Implementation code In them. If all 
the methods are abstract, what does 
an Interface really buy you? 

Polymorphism, polymorphism, 
polymorphism. Interfaces are the 
ultimate in flexibility, because if you 
use interfaces instead of concrete 
subclasses (or even abstract superclass 
types) as arguments and return 



types, you can pass anything that 
implements that interface. And think 
about it — with an interface, a class 
doesn't have to come from just one 
inheritance tree. A class can extend 
one class, and implement an interface. 
But another class might implement 
the same interface, yet come from a 
completely different inheritance tree! 
So you get to treat an object by the 
role it plays, rather than by the class 
type from which it was instantiated. 

In fact, if you wrote your code to use 
interfaces, you wouldn't even have to 
give anyone a superclass that they had 



to extend. You could just give them 
the interface and say,"Here,' I don't 
care what kind of class inheritance 
structure you come from, just 
implement this interface and you'll be 
good to go." 

The fact that you can't put in 
implementation code turns out not to 
be a problem for most good designs, 
because most interface methods 
wouldn't make sense if implemented 
in a generic way. In other words, most 
interface methods would need to 
be overridden even if the methods 
weren't forced to be abstract. 
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Classes from different inheritance trees 
can implement the same interface. 

Robot 



Animal 




When you use a class as a polymorphic type (hke an 
array of type Animal or a method that takes a Canine 
argument), the objects you can stick in that type 
must be from the same inheritance tree. But not just 
anywhere in the inheritance tree; the objects must be 
from a class that is a subclass of the polymorphic type. 
An argument of type Canine can accept a Wolf and a 
Dog, but not a Cat or a Hippo. 

But when you use an interface as a polymorphic 
type (like an array of Pets), the objects can be 
from anywhere in the inheritance tree. The only 
requirement is that the objects are from a class that 
implements the interface. Allowing classes in different 
inheritance trees to implement a common interface 
is crucial in the Java API. Do you want an object 
to be able to save its state to a file? Implement the 
Serializable interface. Do you need objects to run 



their methods in a separate thread of execution? 
Implement Runnable. You get the idea. You'll 
learn more about Serializable and Runnable in later 
chapters, but for now, remember that classes from 
any place in the inheritance tree might need to 
implement those interfaces. Nearly any class might 
want to be saveable or runnable. 

Better still, a class can implement 
multiple interfaces! 

A Dog object IS-A Canine, and IS-A Animal, and 
IS-A Object, all through inheritance. But a Dog IS-A 
Pet through interface implementation, and the Dog 
might implement other interfaces as well. You could 
say: 

piiblic class Dog extends Animal implements 
Pet, Saveable, Paintable { . . . } 
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How do you know whether to make a 
class, a subclass, an abstract class, or 
an interface? 

^ Make a class that doesn't extend anything 

(other than Object) when your new class doesn't 
pass the IS-A test for any other type. 

^ Make a subclass (in other words, extend a class) 
only when you need to make a more specific 
version of a class and need to override or add 
new behaviors. 

^ Use an abstract class when you want to define 
a template for a group of subclasses, and you 
have at least some implementation code that all 
subclasses could use. Make the class abstract 
when you want to guarantee that nobody can 
make objects of that type. 

^ Use an interface when you want to define a role 
that other classes can play, regardless of where 
those classes are in the inheritance tree. 
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Invoking the superclass 
version of a method 

C^I What if you make a concrete subclass 
and you need to override a method, but you 
want the behavior in the superclass version of 
the method? In other words, what if you don't 
need to replace the method with an override, 
but you just want to add to it with some 
additional specific code. 

Ahhh... think about the meaning of the 
word 'extends'. One area of good 00 design looks 
at how to design concrete code that's meant to 
be overridden. In other words, you write method 
code in, say, an abstract class, that does work 
that's generic enough to support typical concrete 
implementations. But, the concrete code isn't 
enough to handle all of the subclass-specific 
work. So the subclass overrides the method 
and extends it by adding the rest of the code. 
The keyword super lets you invoke a superclass 
version of an overridden method, from within the 
subclass. 

l-f method Code msidc a 
Buzi-y/ov-dRcpov-t subdiass says: 

super . runReport ( ) 

the ruhRcpov-tO method msidc 
•the supcrdlass Rcpor-t will \ruh 



abstract class Report { 
void runReport ( ) { 

// set-up report 

} 

void printReport ( ) { 
// generic printing 

} 



class BuzzwordsReport extends Report { 



void runReport ( ) { 

super . runReport ( ) ; ^ 
buzzwordCompliance 0 ; 
printReport ( ) ; 

} 

void buzzwordCompliance () { . . . } 



super.runReportO; 

A v-c-f c\rcr\dc "to "the subdiass objcdt 
(Buz.z.y/ordRcpor-t) will always dall 
•the subclass vcrsioh of ar\ overridden 
method. Tha-t's polymorphism. 

Bu-t ihc subdiass todt tav\ dall 

supc\r.\ruy\Rcpo\r'tO -to invoke "the 
superclass version. 




Ms 



rdass mcbV^ods 



rvA\r\ 



The super keyword is really a re-ferende 
•to •the superclass por-tion o+ an objed-t- 
iVhen subclass dode uses super, as in 
super .runRepor-tO, -the superclass version of 
•the me^thod will run. 
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BULLET POINTS 

y When you don't want a class to be instantiated (in other words, you don't 
want anyone to make a new object of that class type) mark the class with the 
abstract keyword. 

y An abstract class can have both abstract and non-abstract methods. 

y If a class has even one abstract method, the class must be marked abstract. 

y An abstract method has no body, and the declaration ends with a semicolon (no 
curly braces). 

y All abstract methods must be implemented in the first concrete subclass in the 
inheritance tree. 

y Every class in Java is either a direct or indirect subclass of class Object (java.lang. 
Object). 

y Methods can be declared with Object arguments and/or return types. 

y You can call methods on an object only if the methods are in the class (or interface) 
used as the reference variable type, regardless of the actual Oib/ecf type. So, a 
reference variable of type Object can be used only to call methods defined in class 
Object, regardless of the type of the object to which the reference refers. 

y A reference variable of type Object can't be assigned to any other reference type 
without a cast. A cast can be used to assign a reference variable of one type to a 
reference variable of a subtype, but at runtime the cast will fail if the object on the 
heap is NOT of a type compatible with the cast. 
Example: Dog d = (Dog) x.getObject (aDog) ; 

y All objects come out of an ArrayList<Object> as type Object (meaning, they can be 
referenced only by an Object reference variable, unless you use a cast). 

y Multiple inheritance is not allowed in Java, because of the problems associated with 
the "Deadly Diamond of Death". That means you can extend only one class (i.e. you 
can have only one immediate superclass). 

y An interface is like a 1 00% pure abstract class. It defines only abstract methods. 

y Create an interface using the interface keyword instead of the word class. 

y Implement an interface using the keyword implements 
Example: Dog implements Pet 

y Your class can implement multiple interfaces. 

y A class that implements an interface must implement all the methods of the 
interface, since all Interface methods are Implicitly public and abstract. 

y To invoke the superclass version of a method from a subclass that's overridden the 
method, use the super keyword. Example: super . runReport () ; 



There's still something 
strange here... you never 
explained how It Is that 
ArrayLlst<Dog> gives back Dog 
references that don't need to be 
cast, yet the ArrayLlst class uses 
Object In Its methods, not Dog 
(or DotCom or anything else). 
What's the special trick going on 
when you say ArrayLlst<Dog>? 

You're right for calling it a 
special trick. In fact it is a special 
trick that ArrayList<Dog> gives 
back Dogs without you having 
to do any cast, since it looks like 
ArrayList methods don't know 
anything about Dogs, or any type 
besides Object. 

The short answer is that the 
connpiler puts in the cast for you! 
When you say ArrayList<Dog>, 
there is no special class that has 
methods to take and return Dog 
objects, but instead the <Dog> 
is a signal to the compiler that 
you want the compiler to let 
you put ONLY Dog objects in 
and to stop you if you try to add 
any other type to the list. And 
since the compiler stops you 
from adding anything but Dogs 
to the ArrayList, the compiler 
also knows that its safe to cast 
anything that comes out of that 
ArrayList do a Dog reference. In 
other words, using ArrayList<Dog> 
saves you from having to cast 
the Dog you get back. But it's 
much more important than that... 
because remember, a cast can 
fail at runtime, and wouldn't you 
rather have your errors happen 
at compile time rather than, say, 
when your customer is using it for 
something critical? 

But there's a lot more to this story, 
and we'll get into all the details in 
the Collections chapter. 
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1) public 
public 

2) public 
public 



Here's your chance to demonstrate your artistic abilities. On the left you'll 
find sets of class and interface declarations. Your job is to draw the associated 
class diagrams on the right. We did the first one for you. Use a dashed line for 
"implements"and a solid line for^extends" 



WhatHhe Picture? 



1) 



interface Foo { } 
class Bar implements Foo { } 

interface Vinn { } 
abstract class Vout implements Vinn { } 



2) 



public abstract class Muffie implements Whuffie { } 
public class Fluffie extends Muffie { } 
public interface Whuffie { } 




public class Zoop { } 

public class Boop extends Zoop { } 

public class Goop extends Boop { } 



public class Gamma extends Delta implements Epsilon { } 
public interface Epsilon { } 

5) 

public interface Beta { } 

public class Alpha extends Gamma implements Beta { } 
public class Delta { } 
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On the left you'll find sets of class diagrams. Your job is to turn 
these into valid Java declarations. We did number 1 for you 
(and it was a tough one). 

WhatS the Peclaratiow ? 



1) publid t\ass C\\tk { } 

publid diass C\atk t%ity\ds C\'\tk { ] 

2) 



3) 






T 



KEY 



extends 
implements 



I Clack ^ class 
I Clack [ interface 
Clack I abstract class 
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Your job is to take code snippets from the pool and 
place them into the blank lines in the code and out- 
put. You may use the same snippet more than once, 
and you won't need to use all the snippets. Your 
goal is to make a set of classes that will compile 
and run and produce the output listed. 



Nose 



abstract class Picasso implements 



return 7; 



class 



class 



return 5; 



public 



extends Clowns { 



public static void main (String [] args) { 



i [ 0 ] = new 
i [ 1 ] = new 
i [ 2 ] = new 



for(int X = 0; x < 3; x++) { 

System . out . print In ( 

+ .getClass( 

} 



Output I File Edit Window Help BeAfraid" 



5 class Acts 
7 class Clowns 



Note: Each snippet 
from the pool can be 
used more than once! 



Acts( ); 
NoseO; 
Of76( ); 
Clowns( ); 
Picasso( ); 

Of76[] i = newNose[3]; 
Of76 [ 3 ] i; 

Nose [ ] i = new Nose( ); 
Nose [ ] i = new Nose[3]; 



class 
extends 
interface j( ) 
implements j(x) 
i[x] 



public int ilVlethodI ) ; 
public int iMethod { } 
public int iMethod ( ) { 
public int iMethod ( ) { } 



class 
5 class 
7 class 

7 public class 



i.iMethod(x) 
i(x).iMethod[] 
i[x].iMethod() 
i[x].iMethod[] 



Acts 
Nose 
Of76 
Clowns 
Picasso 
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WhatUbe Picture? 



l/inn 



\/ou-t 



'Z-OO? 



Pd-b 



7!V 



Cm-tcv-Padc) 



^ 7^ 

^-^^ ^ 1 ) Cm-tcv-Padc) 




WhatS the PecIaratioM ? 

2J p'^bli^ abs-tv-adt (^lass Top { } 

publid diass Tip c>c-tcr\ds Top { } 

publid abs-tv-ad-t (^lass Fee { } 

publid abs-tradt diass pi c>c-tcr\ds Fee { } 

publid 'm-tcr-fadc Foo { } 

publid diass Bar ir»^plcmcy\-b Foo { } 

public diass Baz. c>c-tcy\ds Bar { } 

public mtcr-fadc ^Icia { } 

publid diass Alpha ir»»plcmcy\-b ^Lcia { } 

publi(^ mtcr-fadc Beta { } 

publid diass Delta oc-tchds Alpha implements Beta { } 
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interface Nose { 

public int iMethod( ) ; 

} 

abstract class Picasso implements NoSe { 

public int iAAethod( ) { 

return 7; 

} 

} 

class Clowns extends Picasso { } 

class Acts extends Picasso { 
public int iMethod( ) { 

return 5; 



public class Of76 extends Clowns { 

public static void main (String [] args) { 

Nose [ ] i = new Nose [3] ; 

i [0] = new Acts( ) ; 

1 1 = new Clowns( ) ; 

i [2] = new Of76( ) ; 

for (int X = 0; x < 3; x++) { 

System. out .println ( i [x] . iMethod( ) 
+ + i [x]. getClass ( ) ); 

} 

} 

} 



Output I File Edit Window Help KillTheMime | 



%java Of 7 6 
5 class Acts 
7 class Clowns 
7 class Of76 
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Life and Death 
of an Object 




Objects ar6 born and objects die. YouVe in charge of an object's llfecycle. 
You decide when and how to construct It, You decide when to destroy it. Except you don't 
actually destroy ihQ object yourself, you i\xr\p\y abandon it. But once it's abandoned, the 
heartless Garbage Cottector (gc) can vaporize it, reclaiming the nnennory that object was 
using. If you're gonna write Java, you're gonna create objects. Sooner or later, you're gonna 
have to let some of them go,or risk running out of RAM. In this chapter we look at how objects 
are created, where they live while they're alive, and how to keep or abandon them efficiently. 
That means we'll talk about the heap, the stack, scope, constructors, super constructors, null 
references, and more. Warning:this chapter contains material about object death that some 
may find disturbing. Best not to get too attached. 
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the stack and the heap 

The ^ack a»id the Heap: where things live 



Before we can understand what really happens when 
you create an object, we have to step back a bit Wc 
need to learn more about where everything lives 
(and for how long) in Java. That means we need to 
learn more about the Stack and tlie Heap, In Java, we 
(programmers) care about two areas of memory — the 
one where objects live (the heap), and the one 
where method invocations and local variables live 
(the stack). When a JVM starts up, it gets a chunk of 
memory from the underlying OS, and uses it to run 
your Java program. How mu^h memory, and whether 
or not you can tweak it, is dependent on which 
version of the JVM (and on which platform) youYe 



running. B\it usually you woji 7 have anything to say 
about it And with good programming, you probably 
won't care (more on that a iitde later). 

We know that all objects live on the garbage-collectible 
heap, but we haven't yet looked at where variables 
live. And where a variable lives depends on what kind 
of variable it is. Ai^d by "kind"", we don't mean type 
(i,e. primitive or object reference). The two kinds ot 
variables whose lives we care about now are insiancs 
variables and Zora/ variables. Local variables are also 
known as stack variables, which is a big clue for where 
they live. 



rh€ Stack 



Where method invocations 
and iocaf variables live 




The Heap 

Where objects live 




Instance Variables 

instance varlabfes are declared tnslde a c/ais but not 
Inside a method.They represent the "fieids^that each 
individual object has (which can be filled with different 
values for each instance of the class). Instance variables 
live inside the object they belong to. 



public class Duck { 



int size;^ ^ _vj ^ 



} 



Local Variables 

Local variables are declared Inside a method, Including 
method parameters. They're temporary^and live only as 
long as the method is on the stack (in other words.as long as 
the method has not reached the closing curly brace). 



public void foo(int x) { 
int i = X + 3; 



.■,iWts > and to 



boolean b = true; tV^' ^J^^^^ 



arc 
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Methods are stacked 

When you call a method^ the method lands on 
the top of a caU stack. That new thing that's 
actually pushed onto the stack is the stack 
fraTney and it holds the state of the method 
including which Hne of code is executing, and 
the values of al] local variables. 

The method at the of the stack is always 
the currentiy-running method for diai stack 
(for now, assume there's only one stack.but in 
chapter 14 we'll add more.) A method suys on 
the stack until the method hits its closing curly 
brace (which means the method's done). If 
method /ooO calls method bar(), method bar() is 
stacked on top of method frnQ, 



A call stock with two methods 




The method on the top of the 
stack 15 always the currently- 
executing method. 



public void doStuff () { 
boolean b = true; 
go(4); 

1 

piiblic void go(int x) ( 
int z = X + 24 ; 
crazy ( ) ; 

// imagine mcr^ c&da here 

} 

public void crazy () ( 
char e ^ ^a' ; 

} 



A stack seeharto 

The code on the left is a snippet (we don't care what the rest of die 
class looks like) \n\h three methods. The first method {doStuffQ) calls 
the second method (go())y and the second raediod calls the third 
(craiyO)^ Each method declares one local variable within the body 
of the method, and method gp{) also declares a parameter variable 
(which means go() has two local ^'ariables). 



Code from another 
doss calls doStuffO> 
and doStuf f 0 goes 
into a stack frame 
at the top of the 
stack.The boolean 
variable ndmed V 
goes on the doStuff Q 
stock frame. 



doStuffO calls 90O. 
goO »5 pushed on 
top of the stack. 
Variables V and "z 
are in the goQ stack 
frame. 




goQ calls croTyO, crazyQ completes, 

crozyO is now on the and its stack frame is 



top of the stack, 
with variable "c" in 
the frame. 




popped off the stack. 
Execution goes back 
to the goO method, 
and picks up at the 
line following the cod 
to crazyO. 
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If 

object references on the stack 



What about local variables that are objects? 



Remennber, a non-primitive variable holds a reference Xo an 
object^ not the object itself. You already know where objects 
live — on the heap. It doesn't matter where they're declared or 
created. If^ local variable is a reference to an object^ only 
the variable (the reference/remote control) goes on the stack. 

The object itself still goes in the heap. 



public class StackRaf { 
public void foof() ( 
barf 0 ; 

) 

public void barf() { 

DucJc d = new Duck (24) 

) 




C^I One more tlm«, WHY are we learning the 
whole stackyheap thing? How do«s this help me? 
Do I really need to learn about M 

Knowing the fundamentals of the Java 
Stack and Heap Is crucial If you want to understand 
variable scope, object creation Issues, memory 
management, threads, and e)(ceptlon handling. 
We cover threads and exception handling In later 
chapters but the others you'll learn In this one. You 
do not need to know anything about how the Stack 
and Heap are Implemented In any particular JVM 
and/or platform. Everything you need to know 
about the Stack and Heap Is on this page and the 
previous one. If you naU these pages, all the other 
topics that depend on your knowing this stuff will 
go much, much, much easier. Once again, some day 
you will SO thank us for shoving Stacks and Heaps 
down your throat. 



— BULUT POINTS ^« 

^ Java has two areas of meinory we care about 
the Stack and the Heap. 

^ Instance variables are variables declared 
rnslde a class but outside any method. 

y Local variables are variables declared inside a 
method or method parameter. 

y All local variables live on the stackjn the 
frame corresponding to the method where the 
variables are declared. 

y Object reference variables wortc just like primi- 
tive variables— if the reference is declared as a 
local variable> it goes on the stack. 

y All objects live in the heap, regardless of 
whether the reference is a local or Instance 
variable. 
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If jocaj variables live oh the stack 
where do instance variables live? 

When you say new CeUPhone(),Java has to make 
space on the Heap for that CellPhone. But how much 
space? Enough for the object, which means enough to 
house all of the object's instaj^ce variables. That's right, 
instance variables live on the Heap, inside the object 
they belong to. 

Remember that the values of an object*s instance 
variables live inside the object If the instance variables 
are all primitives, Java makes space for the instance 
variables based on the primitive type. An int needs 
32 bits, a long 64 bits, etc. Java doesn't care about the 
value inside primitive variables; the bit-sLze of an int 
variable is the same (32 bits) whether the value of the 
int is 32,000,000 or 32. 

But what if the instance variables are objects? What if 
CellPhone HAS-A Antenna? In other words, CellPhone 
has a reference variable of type Antenna. 

When the new object has instance variables that are 
object references ratlier than primitives, the real 
question is: does the object need space for all of 
the objects it holds references to? The ans^ver is, nol 
exactly. No matter what, Java has to make space for the 
instance variable values. But remember that a reference 
variable value is not the whole object, but merely a remote 
control to the objecL So if CellPhone has an instance 
variable declared as the non-primitive type Antenna, 
Java makes space witl^in die CellPhone object only for 
the Antenna's remot£ control {').e. reference variable) but 
not the Antenna object 

Well then when does the Antenna object get space on 
the Heap? First we have to find out when the Antenna 
object itself is created. That depends on the instance 
variable declaration. If the instance variable is declared 
but no object is assigned to it, then only the space for 
the reference variable (the remote control) is created. 

private Antenna ant; 

No actual Antenna object is made on the heap imless 
or until the reference variable is assigned a new 
Antenna object. 

private Antenna ant = new Antenna () ; 




Objcdt wlt^ two prir^i-tivc ins-l:a>%^ vdv-iaklcs- 
SfAU f&r iKc variables lw« i^ tte object 



feKPhpncobjcil!!^^ 




Obj«dt wiiK Ohtf yi<m-{V»mitive va>riabltf— 
d ttftrttiU h> B\e\ A^^e^^a obj«dt but m Actual 
A1^t^^^>^^ object T\\i$ ii wKat you jct i-f yoi* 
dtt\^^ tlr^c vaHable but don't inltialii^ it w»tK 

^ti actual f\f^htr^r^^ objcdt 

public claBS CellPhone ( 
private Antenna ant; 

} 



<^llPhone object 



Antenno object 




iJbjcdt with ok\e norv- primitive iRst^n^t variable, 
arvd the A^t^v^d variable is assi^tied a no; 
^nitr^Y^ object 

public class CellPhone { 

private Antenna ant = new Antenna () ; 

} 
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object creation 

The miracle of objeet creation 

Now that you know where variables and objects live, we can dive into 
the mysterioiis world of object creation. Remember the three steps 
of object declaration and assignment: declare a reference variable, 
create an object, and assign the object to the reference. 

But until now, step two — ^where a miracle occurs and the new object 
is "bom" — has remained a Big Mystery. Prepare to learn the facts of 
object life. Hopeyou*re not squeamish. 



Review the 3 steps of object 
declaration, creation and assignment: 



Declare q reference 
variable 



a ^"^^ ,\3ss 0^ Duck myPuck = new Duck ( ) ; 



buck reference 



^ Create an object 
^^^g — Duck myDuck = new Duck ( ) ; ^ 1^ 




I Link the object and 
the reference 

Duck myDuck new Duck() ; 




buck object 



buck reference 
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Are we calling a method named DuckO? 



Because it sure looks like it. 



^^^^ . p^VO, 



No. 



Duck myDuck = new DuckO ; a '^^^^ . Darcr^^^' 



We're calling the Duck constructon 



A constructor look and feel a lot Jike a method, but it's not 
a method. It*s got the code that runs when you say new. In other 
words, the code that rum when you instantiate an object 

The only way to invoke a constructor is with the keyword now 
followed by the class name. The JVM finds that class and invokes 
the constructor In that class. (OK, technically tlais isn't the only 
way to invoke a constructor. But it s the only way to do it from 
(>wtriif^ a constructor. You can call a constructor from within 
another constructor, with restrictions, but we'll gel into all that 
later in the chapter.) 

But where is the constructor? 
If we didn't write It, who did? 



AOonstmetorbutiiA 

iKido tbit mu vimjra 
iiiitaBtiata an &lf^Mt» la 
oHw mrtif lift eodt tliBl 
mu «lin fov sqr new on 
iidiiilvpe* 

|lmy dm entte ku 
1 c^niif uutofp otbh It yra 



You can write a constructor for your class (we're about to do 
that), but if you don't, the compiler writes one for you! 

Here's what the compiler's defaiUt constructor looks like: 
public DuckO { 
) 

Notice something missing? How Is this 

different from a method? * \s ^'^^ m 

— t\as$»^f*«• 

publiiT' DuckO ( 

// constiructor coda goes here 



} 
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constructing a new Duck 



Cohstruct a Puck 

The key fearare of a constructor is that it runs 
bef&rEihe object can be assigned to a reference. 
That means you get a chance to step in and 
do things to get the object ready for use. In 
other words, before anyone can use the remote 
control for an object, the object has a chance to 
help construct itself. In our Duck constructor, 
we're not doing anything useful, but it still 
demonstrates the sequence of events. 



public class Duck { 

public Duck () { 

System, out .println ( '''Quack") ; 




} 



The constructor gives 
toAt- y^u a chance to step into 

the middle of new. 



public class UseADuck { 

public static void main (St:ring[] args) { 
Duck d = new Duck ( ) ; 



I Fllo Edit Window H&Jp Ouack 



% java UseADuck 
Quack 




pen your pencil 



A constructor lets you jump Into the middle 
of the object creation step— into the middle 
of new. Can you imagine conditions where 
that would be useful? Which of these might 
be useful in a Car class constructor, if the Car 
is part of a Racing Game? Checkoff the ones 
that you came up with a scenario for 



□ Incremenl a counter to track how many objects of this class type 
have been made, 

□ Assign runtime-specific state (data about whales happening NOW). 

□ Assign values to the object's important instance variables. 

□ Get and save a reference to the object that's creating the new object. 

□ Add the object to an ArrayList. 

□ Create HAS-A objects, 

□ (your idea here) 
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iHitialrzing the state of a new Puck 

Most people use constructors to initialize the state of an object. 
In other words, to make and assign values to the object's 
instance variables. 

piiblic DuckO { 
size = 34; 

} 

That's all well and good when the Duck class developer'knows 
how big the Duck object should be. But what if we want the 
programmer who is twmg-Duck to decide how big a particular 
Duck should be? 

Imagine the Duck has a size instance variable, and you want the 
programmer using your Duck class to set the size of the new 
Duck. How could you do it? 

Well, you could add a setSize() setter method to the class. But 
that leaves the Duck temporarily without a size*, and forces the 
Duck user to write two statements — one to create the Duck, and 
one to call the setSize() method. The code below uses a setter 
method to set the initial size of the new Duck. 



public class Duck { 

int size; ^ -.^^r^tt ''a^'*'' 

public DuckO { 

System. out, println(^^Quack'0 ; t<^hc^^ 
) ^ 

public void setSize(int newSize) { ^c^^^ 4-4-#v 
size = newSize; 

} 



public class UseADuck { 

public static void main (String[] args) { 
Duck d = new Duck ( ) ; 



d . setSize (42 ) ; T'' m ii,. !Z t)^ . i- 



*lnstance variables do have a default value. 0 or 
0.0 for numeric primitives, false for booleans, and 
null for references. 



constructors and go 

Duml^tJuestiPtis 

C^I Why do you need to write 
a constructor if the compiler 
writes one for you? 

If you need code to help 
initialize your object and get 
it ready for use, you'll have to 
write your own constructor. You 
might, for example, be depen- 
dent on input from the user 
before you can finish making 
the object ready.There's another 
reason you might have to write 
a constructor, even if you don't 
need any constructor code 
yourself. It has to do with your 
superclass constructor, and we'll 
talk about that in a few minutes. 



How can you tell a con- 
structor from a method? Can 
you also have a method that's 
the same name as the class? 

Java lets you declare a 
method with the same name as 
your class. That doesn't make it 
a constructor, though.The thing 
that separates a method from a 
constructor is the return type. 
Methods must have a return 
type, but constructors cannot 
have a return type. 



Are constructors inher- 
ited? if you don't provide a 
constructor but your superclass 
does, do you get the superclass 
constructor instead of the 
default? 

J\l Nope. Constructors are 
not inherited. We'll look at that in 
just a few pages. 
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initializing object state 



Usihg the constructor to iHitialize 
IwportaMt Pocic state* 

If an object shouldn^i be used until one or 
more parts of its state (instance variables) have 
been initialized, don't let anyone get ahold of 
a Duck object until youVe finished initializing! 
It's usually way too risky to lei someone make — 
and get a reference to — a new Duck object that 
isn't quite ready foruse until that someone turns 
around and calls the seiSize() method. How will 
the Duck-user even knmv that he's required to call 
the setter method after making the new Duck? 

The best place to put initialization code is in the 
constructor. And all you need to do is make a 
constructor witii arguments, 

public clana Duck { 
int size; 




public Duck (int duckSize) { 
System. out. println ("Quack") 

size = duckSize ; 



System. out. println("si2e is + size); 



public class UseADuck { 



public static void main (String[] args) { 



^^^^ Vv^V^^* 



Duck d = new Dude (42) ; 



I File Edit Wlnttow Help Honk 



% java UseADuck 
Quack 



size is 42 



'Not to imply that not al] Duck stale Is not unlmportaoL 
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Make it easy to make a Puck 

sure you have a ho-arg constructor 

What happens if the Duck constructor takes an argumeni? 
Think about it. On the previous page, there's onfy on^Duck 
constructor — and it takes an int argument for the size of the 
Duck. That might not be a big problem, but it does make it 
harder for a programmer to create a new Duck object, especially 
if the programmer doesn't knowwhzi the size of a Duck should 
be. Wouldn't it be helpful to have a default size for a Duck, so 
that if the user doesn't know an appropriate size, he can still 
make a Duck that works? 

Imagine that you want Duck users to have TWO options 
for making a Duck— one where they supply the Duck 
size (as the constructor argument) and one where they 
don't specify a size and thus get your default Duck size. 

You can't do this cleanly with just a single constructor. 
Remember, if a method (or constructor — same rules) has 
a psirameter, you 7nust pass an appropriate argument when 
you invoke that method or constructor. You can't just say, "If 
someone doesn't pass anything to the constructor, then use 
the default size", because they won't even be able to compile 
vrtthout sending an int argument to the constructor calL You 
could do something clunkly like this: 



public class Duck 
int Bizd; 



public Duck (int nawSlze) { -£rCh at>>««^ 
if (nawSise = 0) ( At^V^^'^tr 'tM^^ 

size = nawSize; 



1 



} 



} 



But that means the programmer making a new Duck object has 
to know that passing a "0'' is the protocol for getting the default 
Duck size. Pretty ugly What if the other programmer doesn't 
know that^ Or what if he really does w2j\i a zercnsize Duck? 
(Assuming a zero-sized Duck is allowed. If you don't want 
zero-sized Duck objects, put validation code in the constructor 
to prevent it.) The point ts, it might not always be possible 
to disunguish between a genuine want zero for the size** 
constructor argument and a Tm sending zero so you'll give 
me the default size, whatever that is'* constructor argument. 



You really want TWO ways to 
make a new Duck: 



pid)lic class Duc3c2 { 
int size; 

public Dueyi2{) ( 

// supply default size 
size = 27; 

} 

public Duck2 (int ducJcSize) ( 
// uBO ducJcSize parameter 
size = duckSize; 

1 



To make a Duck when you know the stze: 
I>ucJc2 d = new Duc)c2(15) ; 

To make a Duck when you do not know 
the size: 

Duck2 62 = now DucJt2 () ; 

So this two-optlons-to-make-a-Duck idea 
needs two constructors. One that takes 
an Int and one that doesn'tJfyou have 
more than one constructor In a dass, 
it means you have overloaded 
constructors^ 
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overloaded and defeult constructors 



Pocsw't the compiler alway s 
make a wo-arg constructor 
for you? Wo' 

You might think that if you write only 
a constructor with arguments, the 
compiler will see that you don't have a 
no-arg constructor, and stick one in for 
you. But that's not how it wor}cs. The 
compiler gets involved with constructor- 
making only ifyoudon*t say anything al ail 
about constmcUrrs. 



If you write a constructor that 
takes arguments, and you still 
want a no-arg constructor, 
youMI have to build the no-arg 
constructor yourself! 



OK, let's se£ here,.. "You 
have the right to yoiir own 
constructor." Makes sense. 

"^If you cannot afford a constructor, 
one will be provided for you by the 
compiler, " ^ood to know. 



As soon 2iSyou provide a constructor, 
AJslY kind of constructor, the compiler 
backs off and says, "OK Buddy, looks like 
you're in charge of constructors now." 



if you have more than one 
constructor In a class, the 
constructors MUST have 
different argument lists. 

The argument list includes the order 
and types of the arguments. As long as 
they're differer^t, you can have more 
than one constructor. You can do this 
with methods as well, but we'll get to that 
in another chapter. 
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Overloaded constructors means you have 
more than one constructor in your class. 

To compile^ each constructor must have a 
different argument llsti 

The class below is legal because all four constructors have 
different argument lists. If you had two constructors that took 
only an int, for example, the class wouldn*i compile. What you 
name die parameter variable doesn't count It*s the variable 
type (int. Dog, etc) and order that matters. You can have two 
constructors that have identical types, a& long as the order is 
different A constructor that takes a String followed by an int> is 
not the same as one that takes an int followed by a String. 





piiblic class Muflhrocm { 



public Muflhrooa<int size) ( ) 



don 



public Mushroom ( ) { 1 

public Mushroom (boolean isMagic) { > 
f'public Mushroom (boolean IsMagic^ int size) 
public Mushroom (int size, boolean isMagic) 



{ } 
( 1 



BUUn POINTS 



y Instance variables !ive wrthin the object they belong to. on 
the Heap. 

y If the Instance variable is a reference to an object, both 
the reference and the object it refers to are on the Heap. 

y A constmctor is the code that mns when you say new on 
a class type. 

y A constructor must have the san^e name as the class, and 
must nof have a return type, 

y You can use a constructor to Initiatize tfie state (i.e. the 
instance variables) of the object being constructed. 

y If you don't put a constructor In your class, the compiler 
will put in a default constructor. 

y The default constructor is always a no-arg constructor 

y If you put a constructor-^ny constructor— in your class, 
the compiler will not build the default constructor 



If you want a no-arg constructor, and you've already put 
in a constructor with arguments. you1l have to build the 
no-arg constiuctor yourself. 

Always provide a no-arg constructor if you can. to make It 
easy for programmers to make a working objecL Supply 
default values. 

Overloaded constructors means you have more than one 
constructor in your class. 

Overloaded constructors must have different argument 
lists. 

You cannot have tviw constructors with the same 
argument lists. An argument list Includes the order and/or 
type of arguments. 

Instance variables are assigned a default value, even 
when you don1 explidtly assign one. The default values 
are 0/0.0/false for primitives, and null for references. 
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pen your pencil 



Match the new Duclt () call with the constructor 
that runs when that Duck is instantiated. We did 
the easy one to get you started. 



public class TestDuck { 

public static void main (String {] args) { 

int weight = 8 ; 
float density = 2.3F; 
Stiring name = "'Donald"; 
long[] feathers = { 1 ,2 , 3 , 4 , 5 , 6) ; 
boolean canFly — true; 
int airspeed = 22; 



Duck [J 


d = 


new Duck (7] 


d[0] = 


new 


DuckO ; ^ 


d[l] = 


new 


Duck (density^ weight) ; 


d[2] = 


new 


DuckCnaine, feathers) ; 


d[3] = 


new 


Duck (canFly) ; 


d[4] = 


new 


Duck (3 . 3F, airspeed) ; 


d[5] = 


new 


Duck (false) ; 


d[6] - 


new 


Duck (airspeed, density) ; 



) 



class Duck { 

int pounds = 6; 

float floatability = 2. IF; 

String name - ^^Generic"; 

longi;] feathers = {1 , 2 , 3 , 4 , 5 , 6, 7 y ; 

boolean canFly = true; 

int maxSpeed = 25; 

public Duck() ( 

Sy3t:ein.out<priDtln("t:ype 1 duck") ; 

} 

public Duck (boolean fly) { 
canFly = fly; 

System. out. println ("type 2 duck"); 

) 

public Duck (String n^ long[] t) ( 
name - n; 
feathers = f ; 

System, out, printlnC* type 3 duck"); 

} 

public Duck (int w, float f) { 
pounds = w; 
floatability = f; 

System. out, println(^'^ type 4 duck"); 

} 

public Duck (float density, int max) { 
floatability = density; 
maxSpeed = max; 

System, out. println (''type 5 duck"); 

) 



Earlier you said that It's good to have a no-argu- 
ment constructor so that ff people call the no-arg con- 
structory we can supply defautt values for the "'missing" 
arguments. But aren't there times when Ifs Impossible to 
come up with defaults? Are there times when you should 
not have a no-arg constructor In your class? 

You're right. There are tinnes when a no-arg construc- 
tor doesn't nr^ake sense. You'll see this In the Java API— some 
classes don't have a no-arg constructorThe Color class, for 
example, represents a... color. Color objects are used to, for 
example, set or change the color of a screen font or GUI 
button. When you make a Color Instance, that Instance Is 
of a particular color (you know, Death-by-Chocolate Brown, 
Blue-Screen-of'Death Blue, Scandalous Red, etc.). If you 
make a Color object you must specify the color In some way. 

Color c = new Color (3,45, 200) ; 
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(We're using three ints for RGB values here. We'll get into 
using Color later, in the Swir^g chapters.) Otherwise, what 
would you get? The Java API programmers could have de- 
cided that \f you call a no*arg Color constructor you'll get a 
lovely shade of mauve. But good taste prevailed. 
If you try to make a Color without supplying an argument: 

Color c = now Color <) ; 

The compiler freaks out because it can't find a matching no- 
arg constructor in the Color class. 

I Rte Btiii Window Help SiMBeliwStupkl 



cannot: resolve symbol 
; constructor Color 0 
location: class 
java. aw t. Color 
Color c = new Color () ; 

A 

1 error 



constructors and gc 



Nahoreview: four things to 
rzmmb^r about constructors 



A constructor the code that runs when 
somebody says n©w on a doss type 

Duck d = new Duck ( ) ; 



A constructor must have the same name 
OS the class, and f)o return type 

public Duck(int size) { } 



If you don't put a constructor in your doss, 
the compiler puts in a default constructor 
The default constructor is always a no-arg 
constructor. 

public DuckO { } 



You can have more than one constructor in your class, 
OS long as the argument lists are different. Hovmg 
more than one constructor in o c\q£^ means you have 
overloaded constructors, 

public DuckO { } 

public Duck(int size) { } 

public Duck (String name) { ) 

public Duck (String name, int size) { } 




9:- 



Do constructors have to be public? 



Doing all tha Brain Barbells has been shown to produce a 42% increase in 
neuron size. And you know what they &ay, "Slg neurons..." 



J\l No. Constructors can be piablic, 
private, or default (which means no access 
modifier at all), We'll look more at default 
access in chapter 16 and appendix B. 

How could a private constructor 
ever be useful? Nobody could ever call It, 
so nobody could ever make a new objectl 

But that's not exactly right. Marking 
sonnethlng prlvatie doesn't mean nobody 
can access it/itjust means ihat nobody 
outside the class can access it. Bet you're 
thinking "Catch 22" Only code from the 
same class as the cfass-with-private-con- 
structor can make a new object from that 
class, but without ffrst making an object, 
how do you ever get to run code from that 
class in the first place? How do you ever get 
to anything in that c\ass7 Patience grasshop- 
per We'll get there in the next chapter. 
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space for an object's superclass parts 



Walt a mihute... we never 9\9 talk about 
superclasses and mherltahce and how that all 
fits In with constructors. 

Here's where it gets fun. Remember from the last chapter, tl\e part where we looked at 
the Snowboard object wrapping around an inner core representing the Object portion 
of the Snowboard class? The Big Point there was that every object holds not just its 02jm 
declared instance variables, but also everything Jrrnn its superclasses (which, at a minimum, 
means class Object, since every class extends Object) . 

So when an object is created (because somebody said new; there is no other way to create 
an object other than someone, somewhere saying new on the class type), the object 
gets space for all the instance variables, from aU the way up the inheritance tree. Think 
about it for a moment... a superclass might have sener methods encapsulating a private 
variable. But that variable has to live somewhere. When an object is created, it's almosc as 
though multiple objects materialize — the object being new'd and one object per each 
superclass. Conceptually, though, it's much better to think of it like the picture below, 
where the object being created has layers of itself representing each superclass. 



Object 


Foo a; 




intb; 




intc; 




eqaalsQ 


getClassQ 
hashCodeO 


toStringO 






Snowboard 


Foox 




Fooy 




Hi 




tumQ 








iDddControlO 





Object Kas ihs-Un^-e vayidbles 
e^^fsulat^d by ^ttess. metKods- 
TViCtt in$4:ande variables ^rt 

VrtAhtA wKen ay^Y sub^bis 12 
iKs-Uniiai^d. fTK«€ aven't the 
RBAL Objedi vaviabldi, but 
dat\\ tare what they avc siy^tc 
tKeyVc cys^psulated) 

Sr^owboard also ha^ iMtavwte 
^/aviablcj of its ow>v> so to make 
a £nowboav-d object we v^eed 
spade -for tKc insta^te variables 
of botK tU«cs- 



object on 

tKe heap 




There iJ only object ot^ the heap here- /\ 

Snowboard object. But it Contains both the 
Snowboard farts of itself and the^ gbjedt parts of 
itself - All thstande variables from both diasses have 
to be here. 
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The role of superclass constructors 
m ah object's life. 



AU the constructors in an object's inheritance 
tree must run when you make a new object 

Let that sink in. 

That means every superclass has a constructor 
(because every class has a constructor), and each 
constructor up the hierarchy runs at the dme an 
object of a subclass is created. 

Saying new is a Big Deal, It starts the 
whole constructor chain reacuon. And yes, 
even abstract classes have constructors. 
Although you can never say new on an 
abstract class, an abstract class is soil 
a superclass, so its constructor runs 
when someone makes an instance of a 
concrete subclass. 

The super constructors run to build 
out the superclass parts of the object. 
Remember, a subclass might inherit 
methods that depend on superclass state 
{in other words, the value of instance variables 
in the superclass). For an object to be fully- 
formed, ail the superclass parts of itself must be 
fully-formed, and that's why the super cousuoictor 
must run. All instance variables from every class 
in the inheritance tree have to be declared and 
initialized. Even if Animal has instance variables 
that Hippo doesn't inherit (if the variables are 
private, for example), the Hippo still depends on 
the Animal methods that use those variables. 

When a constructor runs, it immediately calls its 
superclass constructor, all the way up the chain 
until you get to tlie class Object constructor 

On the next few pages, you'll learn how superclass 
constructors are caUed, and how you can call 
them yourself, You'll also learn what to do if your 
superclass constructor has arguments! 




Hippo 



A new Hippo object also JS-A Animal 
and IS-A Objact. If you want to make a 
Hippo, you must also make the Animal 
and Object parts of the Hippo. 

This all happens in a process called 
Constructor Chaining. 



object construction 



Making a Hippo means maklHg the 
Ahimal and Object parts too... 



public class Aninml ( 
public Animal () { 

System, out. println(*^Maitiiig an Animal"); 

} 

} 



public class Hippo axtends Animal { 
public Hippo 0 { 

Sya t«n. out -pr in tin ("'Making a Hippo''); 

} 

\ 



public class TsatBippo ( 

public static void main (String I] arga) { 
System. out .printlnC'Star ting. . ; 
Hippo h = now Hippo () ; 

} 

) 




irpen your pencil 



What's the real output? Given the 
code on the left, what prints out 
when you rur^ TestHlppo? A or B? 

(the answer Is at the bottom of the page) 



I R)e Edit Wmdow Help Swear 



% java TestHippo 
Starting . . . 
Making an Animal 
Making a Hippo 



1 



B 



Fird Edil window Kelp Swdar 



% java TestHippo 
Starting. . . 
Making a Hippo 
Making an Animal 



^ Code from another 
class soys now 
Hippo ()ond the 
WppoO cor\structor 
goes into a stack 
frame at the top of 
the stack. 



A HfppoQ invokes 
the superclass 
corifftructor which 
pushes the AnlmalQ 
constructor onto the 
top of the stack 



@ >Animal() invokes 
the superclass 
constructor which 
pushes the Object() 
constructor onto 
the top of the stack, 
since Object is the 
superclass of Animof. 




ObjectO completes, 
and its stock frame 
is popped off the 
stack, Execution goes 
back to the Animal() 
constructor, and 
picks up at the line 
following Animal's 
call to its superclass 
constructor 
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How do you invoke a superclass constructor? 



You might think that somewhere in, say, a Duck constructor, 
if Duck extends Animal you'd call Animal (). But that's not 
how it works: 

public class Duck ext^ds Animal { 
int size; 



public Duck (int newSize) { 

Animal 0;^ 



aiza = newSize; 



The only way to call a super constructor is by calling super(). 
That's right — superQ calls the super constructor. 

What are the odds? 

public class Duck extends Animal { 
int sizd; 

public Duck (int newSiza) { 



super 0 ; <- 

aiza = nawSiza; 



A call to super() in your constructor puts the superclass 
constructor on the top of the Stack. And what do you 
think that superclass constructor does? Calls its superclass 
constructor. And so it goes until the Object constructor is 
on the top of the Stack, Once Object() finishes, it's popped 
ofif the Stack and the next thing down the Slack (tlie 
subclass constructor that called Object(}) is now on top. 
T/wz^ constructor finishes and so it goes until the onginaJ 
constructor is on the top of the Stack, where itczx\ now 
finish. 



And how is it that we've 
gotten away without 
doing it? 

You probably figured that out. 

Our good friend the compiler 
puts in a call to super() \f you 
don't. 

So the compiler gets Involved In 
constructor-making In two ways; 

If you don't provide a constructor 

The compiler puts one in that looks like: 

public ClassNaneO { 
super 0 ; 

} 



If you i/o provide a constructor 
but you do not put in the call to 
superO 

The compiler will put a call to superO In 
each of your overloaded constructors.* 
The compiler-supplied call looks like: 

super 0 ; 

it always looks like that. The compiler- 
inserted call to superO h always a no-arg 
call. If the superclass has overloaded 
constructors, or^ly the no-arg one Is called. 

'Un(e^ the construcior calls another overloaded 
constaiclor (you'll see ttiat in a few pages). 



you are here ► 253 



object lifecycle 



Can the child exist before 
the parents? 

If you think of a superclass zs the parent to the subclass child, 
you can figure out which has to exist firsL The superclass parts 
of cm object have to be JuUy-formed (completely built) b^re the 
subdass parts can be constructed. Remember, 
the subclass object might depend on things it 
inherits from the superclass, so it*s important 
that those inherited things be finished. No 
way around it. The superclass constructor 
must finish before its subclass constructor. 



Look at the Stack series on page 248 again, 
and you can see that while the Hippo 
constructor is the first to be invoked (it's 
the first thing on the Stack), it's the lastont 
to complete! Each subclass constructor 
immediately invokes its own superclass 
constructor, until the Object constructor 
is on the top of the Stack. Then Object's 
constructor completes and we bounce 
back down the Stack to Animal^s 

constructor. Only after Animal's constructor completes 
do we finally come back down to finish the rest of the Hippo 
constructor. For that reason: 

The call to super() must be the first statement 
In each constructor!* 





Possible constructors for class Boop 



[7f public BoopO { 
super 0 ; 

) 



0 public Boop (int i) ( ^ij^ll^ ^ ihc fi^.^ 
super () ; 
size = 1; 

> 



0 public BoopO { 

) ^ 

0ptiblic Boop (int i) { 
Size = i; ^ 



^public Boop (int i) { 



size = i; 
super 0 ; 



There's an exception to this rule; you'll team It on page 252. 
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Superclass constructors with arguments 

What if the superclass constructor has argumeats? Can you pass something in to 
the superO call? Of course. If you couldn*t, you'd never be able to extend a class 
that didn't have a no-arg constrtictor. Imagine this scenario: all animals have a 
name. There's a getName() method in class Animal that returns the value of the 
n^zm^ instance variable. The instance variable is marked private, but the subclass 
(in this case, Hippo) inherits the getName() method. So here's the problem: 
Hippo has a getJSJarm() method (through inheritance), but does not have the navie 
instance variable. Hippo has to depend on the Animal pan of himself to keep the 
name instance variable, and return it when someone calls geiNain^Oon a Hippo 
object. But... how does the Animal part get the name? Tlie only reference Hippo 
has to the Animal part of himself is through super()y so that's the place where 
Hippo sends the Hippo's name up to the Animal part of himself, so that the 
Animal part can store it in die private rwzw instance variable. 



public abstract class Animal { 
private String name; 4^ 



public String gatKameO 
return nama; 

) 



subtUiSCs) V^avc a ^^^^ 



public Aniioal (String theUame) 
naxne = theNama; - 

} 



public class Hippo extends Animal ( 



public Hippo (String name) { 
super (name) ; 



^\^^<5 toils' 



ho 



Animal 

private String name 



Animal(StTing n) 



String getNameO 



Hippo 



Hlppo(String n) 



[other HIppo-spe- 
clfic methodsl 




public class HakeHippo { 

public static void main (String[] args) ( ^^^tf ^ Wippg 

Hippo h = new Hippo (^^Buffy") ; < ^"^^ '^^^^ a**^ 



System, out. println(h, getNamoO ) ; 



I FUe EdU WlnOow Help Htde 



%java MakeHippo 



1 



Buf fy 
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Ihvokmg om overloaded coHstructor 
from another 



What if you have overloaded constructors that, with 
the exception of handling different argument types, 
all do the sarae thing? You know thai you don*t want 
duplicate code sitting in each of the constructors (pain 
to maintain, etc.), so you'd like to put the bulk of the 
constructor code (including the call to super() ) in only 
of the overloaded constructors. You want whichever 
constructor is first invoked to call The Real Constructor 
and let The Real Constructor finish the job of 
construction. It's simple: just say tkis(). Or tJiis(aStrLfjg). 
Or this(27, x). In other words, just imagine that the 
keyword this is a reference to the current object 

You can say ihis() only within a constructor, and it must 
be the first statement in the constructor! 

But that's a problem, isn't it? Earlier we said that 
superO must be tJie first statement in the constructor. 
Well, that means you get a choice. 

Every constructor can have a call to super() 
or thls(), but never bothi 



class Mini extends Car { 




Color color; 



tails suycvl 



■0). 



public Mini (Color c) { 
superCMini") ; ^ 




color - c; 
// more initializatiion 



FI16 EdiT Wfnetow Help Dfiva 



public Mini(int size) { 
this (Color . Red) ;v 
super (size); A^'-^^-^^ 
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irpen your pencil 



Some of the constructors In the SonOfBoo class will not 
compile. See rf you can recognize which constructors are 
not legal. Match the conripiler errors with the SonOfBoo 
constructors that caused thenrv, by drawing a line from the 
compiler error to the "bad" constructor. 

public class Boo { 

public Boo(int i) ( \ 
public Boo(Stxlng s) ( > 
public Boo(Stj:ing s, int i) { ) 

\ 



The 




clAAfl SonOfBoo extands Boo { 



public SonOfBoo (> ( 
super (^^boo") ; 

} 

public SonOfBoo (int 1) ( 
super (^^Frod") ; 

) 

public SonOfBoo (String a) { 
super (42) ; 

) 

public SonOfBoo(int i. String a) { 
) 

public SonOfBoo (String a* String b. String c) { 
super (ftyb) ; 

) 

public SonOfBoo (int i, int j) { 
super (^^Inan" , j ) ; 

) 

pxsblic SonOfBoo ( int: i, int x, int y) { 
super (L, ''star") ; 

) 



% javac SonOfBoo . java 
cannot resolve symbol 

symbol : constructor Boo 
(java . lang . String , java . la 
ng . String) 



["Re Edit Window Help Yadayadayada H 



%javac SonOfBoo . java 

cannot resolve symbol 

symbol : constructor Boo 
(int , java . lang . String) 



I Rle Edh Wtndow Haip ImNoaJstenffig" 



i javac SonOfBoo. java 
cannot resolve symbol 
symbol : constructor Boo ( ) 
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Now we kMow how ah object is horn, 
but how lohg does aK object //Vf ? 

An object's life depends entirely on the life of references 
referring to iL If the reference is considered "alive", the 
object is still alive on the Heap. If the reference dies 
(and we'll look at what that means in just a rtiomeni)> ihc 
object will die. 

So if an object^s life depends on the reference 
variable's life, how long does a variable live? 

That depends on whether the variable is a Zoco/ variable 
or an instaTice v^nzh\c. The code below shows the life of a 
local variable. In the example, the variable is a primitive, 
but variable lifetime is the same whether it's a primitive 
or reference variable, 

public class TestLifeOne { 

public void readO { 

int s = 42; ^ - }^ ^ 

public void sleep () { 




A local variable lives only 
within the method that 
declared the variable. 

public void read() ( 
int s = 42; 

// *s' aan bfi usod only 

7/ within this method. 

// When this method ends, 

// 's' disappears completely. 

} 

Variable's' can be used o^/y within the 
readQ method. In other words, the variable 
Is In scope only within Its own method. No 
other code in the class (or any othef class) 
can see's'. 



An instance. variable lives 
as long as the object 
does. Iff the object is still 
alive, so are its instance 
variables. 

public class Life { 
int size; 

public void setSi2e(int s) { 
size = s; 



's' disappears at the 
end of this method. 



// 
// 

// but 'size' can be used 
// anywhere in the class 



} 



Variable's' (this tinnea method parameter) 
Is In scope only within the selSizeO 
method. But instance variable size is 
scoped to the life of the object as opposed 
to the life of the method. 
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The difference between life and 
scope for local variables: 

Life 

Aloca] variable is alive zs long as its Stack 
frame is on the Stack. In oiher words, 
until the method completes. 

Scope 

A local variable is in scope only within the 
method in which the variable was declared. 
When its own method calls another, the 
variable is alive, but not in scope until its 
method resumes. You can use a vttriable only 
when it is in scope. 



public void doStuff () { 
boolean b = tjrue; 
go(4); 

} 

public void go(liit x) { 
int z = X + 24; 
crazy 0 ; 

// imagine more code here 

} 

public void craryO ( 
char c ™ ^a' ; 




A doStuffQ goes on thd ^^9^0 plops on top of crazyQ Is pushed orrto A craiyQ completes and 

Stack, Variable -b' Is ^the Stack, V and ^ the Stack, with 'c' now ^ Is popped off the Stack, 

alive and In scope. are alive and tn scope, alive and In scope. The so 'c* Is out of scope 

and V Is alive but nof other three variables and dead. V\^en goQ 

in scope. are alive but out of resumes where it left 

scope. off, 'x' and 'z' are both 

alive and back in scope. 
Variable V Is still alive 

While a local variable is alive, its state persists. of scope (until 

As long as method doStuflf() is on the Stack, for fl^O completes), 
example, the 'b' variable keeps its value. But the 
'b' variable can be used only while doStu£f() s 
Stack frame is at the top. In other words, you can 
use a local variable only while that local variable's 
method is actually running (as opposed to 
waiting for higher Stack frames to complete). 
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What about reference variables? 

The rules are the same for primtives and references. A reference 
variable can be used only when it's in scope» which means you can*t use 
an object^s remote control unless youVe got a reference variable that's 
in scope. The r^^zZ question is, 

"How does variable life affect object life?^^ 

An object is alive as long as there are live references to iL If a reference 
variable goes out of scope but is still alive, the object it refers to is still 
alive on the Heap. And then you have to ask... "What happens when the 
Stack frame holding the reference gets popped off the Stack at the end 
of the method?" 

If that was the only live reference to the object, the object is now 
abandoned on the Heap. The reference variable disintegrated with 
the Stack frame, so the abandoned object is now, officuilly, toast The 
trick is to know the point at which an object becomes eligible for garbage 
collection. 

Once an object is eligible for garbage collection (GC), you don't have 
to worry about reclaiming the memory that object was using. If your 
program gets low on memory, GC wU destroy some or all of the eligible 
objects, to keep you from running out of RAM. You can sdll run out of 
memory, but noi before all eligible objects have been hauled off to the 
dump. Yourjob is to make sure that you abandon objects (i.e, make 
them eligible for GC) when you're done with them, so that the garbage 
collector has something to reclaim, ff you hang on to objects, GC can't 
help you and you run the risk of your program dying a painful 
out-of-memory death. 



An object's life has no 
value, no meaning, no 
point, unless aomebody 
has a reference to rt 

If you cant gettoii 
you cant ask ft to do 
anything and it's just a 
big fat waste of bits. 

But if an object is 
unreachable, the 
Garbage Collector wiU 
figure that out Sooner 
or later, that object's 
goin' down. 




An object becomes 
eligible for GC when 
its last live reference 
disappears. 



Three ways to get rid of an object's reference: 

The reference goes out of scope, permanently 



void go ( ) { 

Lifa z = TXM Li£a(); 

} 



(2) The reference \s assigned another object ^ ^r^cf^ 

Life z = naw Life() ; . -l^^ ^''^^ Jrdm*^^' ^ 

z = new LifeO; ^^-^ v^Kcn^"*^ ^^^^ 

The reference is explicitly set to null . . ^u^ivclof^ci 

^ ^\str^^'' ^^^^ 



Lifa 2 = naw Llfa() 
z » null; 
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Object-killer #1 

Reference goes 
out of scope, 
permanently. 




public class Staclcll^f { 
public void foof () { 
barf 0 ; 

} 

public void barf () { 
Duck d = nd*f Duc]c() 

} 



/bo/Q Is pushed onto the 
Stack, novaiiablas ara 
declared. 



barfO Is pushed onto the 
Stack, whom It declares 
a reference variable^ and 
creates a new object as- 
signed to that reference. 
The object Is created on 
the Heap, and the refer- 
ence Is alive and In scope. 






1-1 



barfQ completes and pops 
off the Stack. Us frame 
disintegrates, so 'd' is now 
dead and gone, Execution 
returns to foo^, but foofQ 
can*t use 'd' . 





WK-oK. "TVic 'd' variable 
yicni away Vf/K^n the bavfO 
£iaik ^ramc ^a^ blow>^ 

ii abandoned, ^arba^c- 
t4>\\ttior bait 
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Object-killer #2 

Assign the reference 
to another object 




public class ReRaf { 

Duck d = new DuckO ; 

public void go() { 
d = new Duck () ; 




«ev, Duik ftocs on Heap, 

pUw^ll W as U^as -fc^e ReRe-f objett 
ti,a^: iniiantaUd i4 'is alwe- U*.le«- 




tails 




•d' a^i^nea a new Dutk obje^i '"-""^aJJ'' 
ori^mal ^^iv.t) Dutk object abandoned. T>,at 
fivsi Dudk IS now ai a«>d as dead. 
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ObjecMciller #3 

Explicitly set the 
reference to null 




public class R^Ref { 

Duck d = Mw Duck ( ) / 

public void go() ( 
d = null; 

} 



The meaning of null 

When you seta reference to null, you're 
deprogramming the remote control. 
In other words, you've got a remote 
control but noTV at the other end. A null 
reference has bits representing 'null' (ive 
don't know or care what those bits are, as 
long as the JVM knows). 

(f you have an unprogrammed remote 
control, In the real world, the buttons don't 
do anything when you press them. But 
in Java, you can't press the buttons (Le. 
use the dot operator) on a null reference, 
because the JVM knows (this Is a runtime 
Issue, not a compiler error) that you're 
expecting a bark but there's no Dog there 
todotti 

If you the dot operator on 
a null reference, you'll get a 
NullPolntefExceptlon at runtime. You'll 
learn all about Exceptions In the ftisky 
Behavior chapter. 




n« DvA joes o. ■k^«e ^cAY. rtftrer^A 
PuA will IWe a* lon5 !<tRt( objett 
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Fireside Chats 




Tonight's Talk: An instance variable and 
a local variable discuss life and death 
(with remarkable civility) 



Instance Variable 

Vd like to go first, because I tend to be more 
important to a program than a local variable. 
Tm there to support an object, usually 
throughout the object's entire life. After all, 
what*s an object without stat^ And what is 
state? Values kept in instance variables. 



Local Variable 



No, don 't get me wrong, I do understand your 
role in a method, it's just that your life is so 
short. So temporary. That's why they call you 
guys "temporary variables'*. 



My apologies. I understand completely. 



I never really thought about it like that. What 
are you doing while the other methods are 
running and you're waiting for your frame to 
be the top of the Stack again? 



I appreciate your point of view, and I certainly 
appreciate the value of object state and ali, 
but 1 don't want folks to be misled. Local 
variables are really important. To use your 
phrase, "After all, what s an object without 
behavior^** And what is behavior? Algorithms 
in methods. And you can bet your bits there'll 
be some local variables in there to make those 
algorithms work. 

Within the Jocal-variable community, the 
phrase "temporary variable" is considered 
derogatory. We prefer "local", "stack", "auto- 
matic", or "Scope-challenged". 

Anyway, it's tnie that we don't have a Jong 
life, and it s not a particularly good life either 
First, we're shoved into a Stack frame with 
all the other local variables. And then, if the 
mediod we're part of calls another method, 
another frame is pushed on top of us. And if 
that method calls another method... and so on. 
Sometimes we have to wait forever for aU the 
other methods on top of the Stack to com- 
plete so that our method can run again. 



Nothing. Nothing at all. It's like being in 
stasis — that thing they do to people in science 
fiction movies when they have to travel long 
distances. Suspended animation, really. We 
just sit there on hold. As long as our frame is 
still there, we're safe and the value we hold 
is secure, but it's a mixed blessing when our 
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Instance Variable 



We saw an educational video about it once. 
Looks like a pretty brutal ending. I mean, 
when that method hits its ending curly brace, 
the frame is literally blown off the Stack! Now 
^^a^'S gotta hurt. 



I live on the Heap, with the objects. Well, not 
with the objects, actually in an object. The 
object whose state I store, I have to admit life 
can be pretty luxurious on the Heap. A lot of 
us feel guilty, especially around the holidays. 



OK, hypothetically, yes, if Fm an instance 
variable of the Collar and the Collar gets 
GC'd, then the Collar's instance variables 
would indeed be tossed out like so many pizza 
boxes. But I was told that this almost never 
happens. 



They let us drinks 



Local Variable 

frame gets to run again. On the one hand, we 
get to be active again. On the other hand, the 
clock starts ticking again on our short lives. 
The more time our method spends running, 
the closer we get to the end of the method. 
We /^//know what happens then. 



Tell me about it In computer science they use 
the term popped as in "the frame was popped 
off the Stack". That makes it sound fun, or 
maybe like an extreme sport. But, well, you 
saw the footage. So why don't we talk about 
you? I know what my littie Stack frame looks 
like, but where do you live? 



But you don't always live as long as the object 
who declared you, right? Say there's a Dog 
object with a Collar instance variable. Imagine 
you're 3X1 instance variable of the CoZZar object, 
maybe a reference to a Buckle or something, 
sitting there all happy inside the Co//ar object 
who's all happy inside the Dog object. But... 
what happens if the Dog wants a new Collar, 
or nulls out its Collar instance variable? That 
makes the Collar object eligible for GC. So... 
if youre?in instance variable inside the Collar, 
and the whole Collar h abandoned, what 
happens to you} 



And you believed it? That's what they say to 
keep us motivated and productive. But aren't 
you forgetting something else? What if you're 
an instance variable inside an object, and that 
object is referenced only by a Zo^:a/ variable? If 
I'm the only reference to the object you're in, 
when I go, you're coming with me. Like it or 
not, our fates may be connected. So I say we 
forget about all this and go get drunk while 
we still can. Carpe RAM and all that. 
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exercise: Be the Garbage Collector 



BE Garbage CoU^jpt 

"■^ of 4e hxm of code ontbe riglit, if added 

to ^ class on left at poitrt A. would caase 
exactly one additSond object fo be eli^le for tbe 
Garbage Collector? G^sonie fliat point A (//call 
more rnefiiods) wilJ execute for a loi^ time, ^yin^ tie 
(jarbage Collector tiine to do its staff.) 




public class GC { 

public static GC doStuff () { 
GC newGC = new GC{); 
doStuff2 (newGC) ; 
return newGC; 

} 

public static void main (String [] args) { 
GC gel; 

GC gc2 = new GC 0 ; 
GC gc3 = new GC 0 ; 
GC gc4 - gc3; 
gcl = doStuf f () ; 



// call more methods 



public static void doStuf f2 (GC copyGC) ( 
GC localGC 

1 



1 copyGC = null; 

2 gc2 - null; 

3 newGC = gc3; 

4 gel - null; 

5 newGC = null; 

6 gc4 = null; 

7 gc3 = gc2; 

8 gel = gc4; 

9 gc3 = null; 
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Honey [ ] beeHA; 

> 



class Raccoon { 
Kit k; 
Honey rh? 

} 

class Kit ( 
Honey kh; 

> 

class Bear { 
Honey hunny; 



In this code example, several new objects are created. 
Your challenge is to flr^d the object that is 'most popular', 
i.e. the one that has the most reference variables referring 
to it. Then list how mony total references there are for 
that object, and what they are! We'll start by pointing oat 
one of the new objeas, and its reference variable. 

Good Luck) 



public class Honey { 

public static void main (String [] args) { 
Honey honeyPot = new Honey(); 

Honey [ ] ha = ^ honeyPot y honeyPot, honeyPot, honeyPot}; 

Bees bl = new Bee8(); 

bl.beeRA = ha; 

Bear [ ) ba = new Bear[5]; 

for (int x-0; x < 5; x++) { 

ba[x] = new Bear( ) ; 

ba[x], hunny - honeyPot; 

Kitk = newKit(); ^ 
k.kh = honeyPot; 

Raccoon r ^ new Raccoon(); ^ 

Herd's Its reference 

r.rh = honeyPot; variable V. 

r.k = k; 
k = null; 
} // end of main 

} 
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puzzle: Five Minute Mystery 





'"We've run the simulation four times, and the nuin module's temperature consistently 
drifts out of nominal towards cold", Sarah said, exasperated. "We installed the new temp-bots last 
week. The readings on the radiator bots, designed to cool the living quarters, seem to be within 
spec, so weVe focused our analysis on die heat retention bots, the bets that help to warm the quar- 
ters " Tom sighed, at first it had seemed that nano-technology was going to really put them ahead 
of schedule. Now, with only five weeks left until launch, some of the orbiter*s key life support 
systems were still not passing the simulation gaundet. 

''What ratios are you simulating?", Tom asked. 

"Well if I see where you're going, we already thought of that'*, Sarah replied, "Mis- 
sion control will not sign off on critical systems if we run them out of spec. We are 
required to run the v3 radiator bot*s SimUnits io a 2: 1 ratio with the v2 radiator*s 
SimUnits", Sarah continued. "Overall, the ratio of retention bots to radiator bots is 
supposed to run 4:3.'* 



'How's power consumption Sarah?", Tom asked. Sarah paused, '*Well that^s 
another thing, power consumption is running higher than anticipated. We've got a team 
tracking that down too, but because the nanos are wireless it's been hard to isolate the power 
consumption of the radiators from the retention bots/' ''Overall power consumption ratios", Sarah 
continued, ''are designed to run 3:2 with the radiators pulling more power from the wireless grid " 

''OK Sarah", Tom said *'Let's take a look at some of the simulation initiation code. 
We've got to find this problem, and find it quickl" 



traport java.utii.*; 
class V2Radiator { 

V2Radiator(Arrayi.ist list) { 
for(int x«0; x<57 x-m-) { 

list. add( new SiJnUnit( "VZRadiator" ) ) ; 

> 



> 



class V3Radiator extends V2Radiator ( 
V3Radiator(ArrayLi8t Igliat) ( 
super ( Igllfit) ; 
for(int <3^0} g<10) g-H-) { 

lgli8t.add(new SimUnit( "VSRadiator" ) ) ; 

) 

) 

) 



class RetentionBot < 

RetentlonBot (ArrayLiflt rliflt) { 

rlist. add(new Si!ttDnit( "Retention' ) ) ; 

) 

) 
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public class TestLif eSupportSim { 



public static void main (String [} args) { 
ArrayList aList = new ArrayList(); 



V2Radiator v2 = new V2Radiator (aList) ; 
V3Radiator v3 = new V3Radiator ( aList ) ; 
for(int z=0; z<20; z++) { 



RetentionBot ret = new RetentionBot ( aList ) ; 

} 

} 

} 

class SimUnit { 
String botType; 
SimUnit (String type) { 
botType = type; 

} 

int powerUse( ) { 

if ("Retention". equals (botType) ) { 

return 2 ; 
> else { 
return 4; 



Tom gave the code a quick look and a small smile creeped across his lips, I think I've 
found the problem Sarah, and I bet I know by what percentage your power usage readings are off 
too! 



What did Tom suspect? How could he guess the power readings errors, and what few 
hues of code could you add to help debug this program? 



} 



} 



} 
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1 copyGC = null; No - this line attempts to access a variable 
that is out of scope. 

EjfiBTCiSB ^S^^tttiollS 2 " null; OK - 9c2 was the only reference variable 

referring to that object. 

3 newGc = gc3i No - another out of Scope variable. 

4 gel = null; OK - gcl had the only reference because 
Q*^, newSC is out of scope. 

5 newGC ^ null; No - r\ew6C is out of scope. 

6 gc4 = null; [sjo - gc3 Is Still referring to that object. 

7 gc3 - gc2; fsjo - gc4 is fftill referring to that object, 

8 gcl - gc4; OK - Reassigning the only reference to 
that object, 

9 gc3 = null; No - gc4 (S Still referring to that object. 



object 



A 



it probably wasnt too hard to figure out that the Honey objea first referred to by the honeyPot variable is by 
far the most'poputar'object In this class. But mayi:>e it was a little trickier to see tliat all of the variabies that 
point from the code to the Honey object refer to the same o6/ectl There are a total of 1 2 active references to 
this object right before the maln( ) method completes. The Ickl) variable is valid for a while, but l< gets nulied 
at the end Since r./c still refers to the Kit object rJckh (although never explldty declared), refers to the objectl 

public claflB Honey { 

public static void main (String [] arga) { 

Honey honeyPot new Boney(); 

Honey [ ] ha = {honeyPot, honeyPot, 

honeyPot, honeyPot) ; 
Bees bl « new Bees{)? 
bl .beeHA - ha; 
Bear [ ] ba new Bear{5]; 
for (int x-0; x < 5; x^-^) { 
ba[x] = new Bear(); 
ba[x]. bunny « honeyPot; 

> 

Kit k = new Kit( ) ; 
k.kh =» honeyPot; 
Raccoon r * new Raccoon ( ) ; 

r*rh = honeyPot; 
r.k « k; 
k * null; 
} // end of main 
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Tom noticed that the constructor for the V2Radiator class took an 
ArrayList. That meant that every time the ViRadiator constructor was called, 
it passed an ArrayList in its super() call to the V2Radiator constructor. That 
meant that an extra five V2Radiator SimUnits were created. If Tom was right, 
total power use would have been 120, not the 100 that Sarah's expected ratios 
predicted. 

Since all the Bot classes create SimUnits, writing a constructor for 
the SimUnit class, that printed out a hne everytime a SimUnit was created, 
would have quickly highlighted the problem! 
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1 0 numbers and statics 

Numbers Matter 




Do the Math. But there's more to working with numbers than just doing primitive 
arithmetic. You might want to get the absolute value of a number, or round a number, or find 
the larger of two numbers. You might want your numbers to print with exactly two decimal 
places, or you might want to put commas into your large numbers to make them easier to read. 
And what about working with dates? You might want to print dates In a variety of ways, or even 
manipulate dates to say things like/add three weeks to today's datet And what about parsing 
a String into a number? Or turning a number into a Strmg? You're in luck. The Java AP[ Is full of 
handy number-tweaking methods ready and easy to use. But most of them are static so we'll 
start by learning what it means for a variable or method to be static including constants in 
Java— static fmal variables. 
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MATH methods: as close as you'll 
ever get to a global mihoi 

Except there's no global anything \n]z.va. But think about 
this: what if you have a method whose behavior doesn't 
depend on an instance variable vahie. Take the round() 
method in the Math class, for example. It does the same 
thing every time — rounds a floating point number(the 
argument to the method) to the nearest integer. Every 
time. If you had 10,000 instances of class Math, and ran 
the round(42.2) method, you'd get an integer value of 
42. Every time. In other words, the method acts on the 
argument, but is never affected by an instance variable 
state. The only value that changes the way the round() 
method nms is the argument passed to the method! 

Doesn^t it seem like a Tvaste of perfectly good heap space 
to make an instance of class Math simply to run the 
roundO method? And what about other Mdith methods 
like min(), which takes two numerical primitives and 
returns the smaller of die two. Ormax(). Or abs(), which 
returns the absolute value of a nimiben 

These methods never use instance variable values. In fact the 
Math class doesn't havezr\y instance variables. So there's 
nothing to be gained by making an instance of class 
Math. So guess what? You don't have to. As a matter of 

fact, you can'L 

If you try to make an instance of 
class Math: 

Math mathObject = new Math() ; 

You'll get this error: 



Metikckls in Ae Madi class 
don't use any instance 
vafiable values. And because 

mediods are 'st3fic\ 
you don't i^eed to Kave an 
instance of JVIafii. All you 
need is 4e MafJi class. 



int X = Math.round(42.2) ; 
int y = Math.min(56,12) ; 
int z = Math.ab3(-343) ; 



^^^^ is rM^ked Privai«/ TL,+ 



%javac TestMath 

TestMath, java:3: Math(> has private 
access in java.lang.Math 

Math mathObject = new Math(); 
1 error 
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The difference between regular 
(noH-static) and static methods 

Java is object-oriented ^ but once m a while you have a special case, 
typically a utility method {like the Math methods), where there is 
no need to have am instance of the class. The keyword static lets 
a method run without any instance of the class. A static method means 
"behavior not dependent on an instance variable, so no instance/object 
is required. Just the class.'' 



regula r (non-static) method 

public class Song { ^^^^\^ .Mj^^"^^ 

String ti.le; ^ 1^^^^::. 
public Song ^String t)^^.yho<l. 
title = t; 

) 

public void playO ( 

SoundPlayer player = naw Soundf>layer() ; 
player .playSound (title) ; 





Song 
s2.play() ; 



Song 
S3. play 0 ; 

, / 

^threr^ will diwe 
>ytViy"t»p|jy. 



Static method 



public Int min (int a, int b) { 

//returns tha laaaar of a and b 




Hath. min (42, 36) ; 



name- 
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Call a static method using a 
class name 



Math 1 




mInO 
maxO 
absO 


r 



.min(B8,86) ; 



Call a non-static method using a 

reference variable name 



Song t2 » new Song() ; 
■•play 0 ; 




What it means to have a 
class with static methods. 



Often (although not always), a class with static 
methods is not meant to be instantiated. In Chapter 
8 we talked about abstract classes, and how marking 
a class with the abstract modifier makes it 
impossible for anyone to say 'new' on that class type. 
In other words, it's impossible to insUmiiate an abstract 
doss. 

But you can restrict other code from instantiating 
a nc^b-abstract class by marking the constructor 
private. Remember, a method marked private means 
that only code from within the class can invoke 
the method. A cofLstructar mzikcd private means 
essentially the same thing — only code from within 
the class can invoke the constructor Nobody can 
say 'new' from oulsidsxhe class. That's how it works 
with the Math class, for example. The constructor 
is private, you cannot make a new instance of Math. 
The compiler knows that your code doesn't have 
access to that private constructor 



This does not mean that a class with one or more 
static methods should never be instantiated. In fact, 
every class you put a main() method in is a class with 
a static method in it! 

Typically you make a main() method so that you 
can launch or test another class, nearly always by 
instantiating a class in main, and then invoking a 
method on that new instance. 

So youVe free to combine static and non-static 
methods in a class, although even a single non-static 
method means there must be iow way to make an 
instance of the class. The only ways to get a new 
object are through 'new' or deserialization (or 
something called the Java Reflection API that we 
don't go into). No other way. But exactiy whos^Lys new 
can be an interesting question, and one we'll look at 
a Little later in this chapter. 
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Static methods can't use non-static 
(instance) variables! 

Static methods mn without knowing about any particular 
instance of the static method's class. And as you saw on 
the previous pages> there might not even ^^any instances 
of that class. Since a static method is called using tlie cUiss 
(MatJur^ndomO) as opposed to an instance reference (^.playO)^ 
a static method can*t refer to any instance variables of the 
class. The static method doesn*t know whkh instance *s variable 
value to use. 



If you try to compile this code: 

public Glass Duck < 
private int size; 



I 



public static void main (String [] args) { 

Syatem.out.println ("SizG of duck is " + size); 

^ !f <» t)ut\c on 

public void aetSizd (int a) ( , ',!"^P »<"»ewh«-e, we 
siee = a; k^^w ii 

) 

public int g«tSize() ( 
retuxn size; 

) 



If you tiy to use an 
instance variable from 
inside a static neAioi, 
tliecomplerilanfes, 
1 don't Itnow wAici 
object's instance variable 
you re talking about!" 
If you have ten Duck 
objects on Ae Keap, a 
Static neAiod doesn't 
"know about any of iien- 



You'll get this error: 




% javac Duck . java 

Duck,java:6: non-static variable 
size cannot be referenced from a 
static context 

System. out .print In ("Size 
of duck is + size) ; 
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Static methods can't use Hon-static 
methods, either! 

What do non-static methods do? Uiey usually use instance 
variable state to affect the behauwr of the methoiL A getName () 
method returns the value of the name variable. Whose name? 
The object used to invoke the getName () method. 



This won't compile: 

public claaa Duc3c { 
private int size; 



public static void main (String [] args) { 

Syat^vout .println ("Size is + getSizeO); 

) 

public void setSiza(int a) { 
size = s; 

) 

public int getSizeO / 
return size; 



Into Edit WIfKJow Heip Jack-In 



% javac Duck , java 

Duck.java:6: non-static method 
getSizeO cannot be referenced 
from a static context 

System, out , print In ( ''Size 
of duck is + getSize 0 ) 



What If you try to caJI a non-static 
method from a static method, but the 
non-static method doesn't use any in- 
stance variables. W7I1 the compiler allow 
that? 



A: 
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No, The compiler knows that 
whether you do or do not use Instance 
variables In a non-static method, you can. 
And think about the implications... if you 
were allowed to compile a scenario like 
that then what happens if in the future 
you want to change the implementation 
of that non-static method so that one day 
it does use an instance variable? Or worse, 
what happens if a subclass overrides the 
method and uses an instance variable in 
the overriding version? 

I could swear I've seen code that 
calls a static method using a reference 
variable Instead of the class name. 

J^'. You can do that, but as your mother 
always told you/Just because it's legal 
doesn't mean it's good.'' Although it works 
to call a static method using any instance 
of the class, it makes for misleading (less- 
readable) code. You can say, 

Duck d = DOW Duck() ; 
String [] s = { ) ; 
d. main (ft) ; 

This code is legal, but the compiler Just 
resolves It back to the real class anyway 
("OKr ^ Is of type Duck, and malnQ Is static, 
so ril call the static main{) in class Duck''). 
In other words, using d to Invoke mainQ 
doesn't imply that maln() will have any 
special knowledge of the object that d Is 
referencing. It's Just an alternate way to 
Invoke a static method, but the method Is 
still static! 
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Static variable: 

value is the same for ALL 
ihstaHces of the class 

Imagine you wanted to count how many Duck 
instances are being created while your program is 
running. How would you do it? Maybe an instance 
variable that you increment in the constructor? 

claas Duck { 

int ducJcCount = 0; 
public Duck() { 
duc]cCount++; 



} 



) 



No, that wouldn't work because duckCount is an 
instance variable, and starts at 0 for each Duck. You 
could try calling a method in some other class, but 
that's kludgey. You need a class that's got only a single 
copy of the variable, and all instances share that one 
copy. 

That^s what a static variable gives you; a value shared 
by all instances of a class. In odier words, one value 
per class, instead of one value per instance. 



public class Duck { 



siz«; ^ 

int duckCount « 0; 

public Ducko ( ^<.wiiwi;/^ 



public void aatSiza(lnt 
size = s; 

} 

public int getSiz«() { 
return fliz«; 



i) ( 





Duck 


size 

static duckC 


ountf 


getSizeO 
setSizeO 





22^ 
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Static varial>Us are skarecL 

All instances ol tke same 
class skare a single copy o{ 
tke static variables. 



instance variables: 1 per instance 
static variobles: Ipercloss 




Brain Barbell 



Earlier in this chapter, we saw that a private 
constructor means that the class can't be instantiated 
from code running outside the class. In other words, 
only code from withrn the class can make a new 
instance of a class with a private constructor. (There's 
a kind of chlcken-and-egg problem here.) 

What If you want to write a class In such a way that 
only ONE instance of It can be created and anyone 
who wants to use an instance of the class will always 
use that one, single Instance? 
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Initializing a static variable 

Static variables are initiaUzeci when a class is loade± A class is 
loaded because the JVM decides it's time to load it. TypicaUy, 
the JVM loads a class because somebody's trying to make a 
new instance of the class, for the first dme, or use a static 
method or variable of the class. As a programmer, you also 
have the option of telling the JVM to load a class, but you're 
not likely to need to do that. In nearly all cases, you're better 
off letting the JVM dedde when to load\ht class. 

And there are two guarantees about static initializadon: 

Static variables in a class are initiaLLzed before any object of that 
class can be created. 

Static variables in a class are initialized before any static metJiod 
of the class runs. 

clAflS Player { 

static int playerCount = 0; 

private String name; 

public Player (String n) { 

name = n; 

playerCoimt++ ; 



static variables 
In a class are 
initialized beform 
any object off 
that class can 





} 



public claaa PlayarTaatDrive { 

public static void main (String [] args) { 
System, out . println (Player .playerCount) 
Player one = new Player (''Tiger Woods") 
System, out .pr in tJ.n (Player .playerCount) 



'^^9- fUj, ^ 



} 



htu^ a statt va/.able j^t li^c a siat>6 
d>od-vwitK dais narr^e. 



Static variables are initialized when the class is loaded. If you 
don't explicidy initialize a static variable (by assigning it a 
value at the time you declare it), it gets a default value^ so int 
variables are initialized to zero, which means we didn't need 
to explicidy say "playerCount = 0". Declaring, but not initial- 
izing, a static variable means the static variable will get the de- 
fault value for that variable type, in exacdy the same way that 
instance variables are given default values when declared. 



|f]16 Etfit Wfodow Htfp What? 



% java PiayerTestDrive 
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Static final constants 

static fihal variables are coHstants 

A variable marked firm 1 means that — once initialized — it can 
never change. In other words, the value of the static final variable 
will stay the same as long as the class is loaded. Look up Math.PI 
in the API, and you'll find; 

public static final double PI = 3.141592653589793; 

The variable is marked public so that any code can access it. 

The variable is marked static so that you don't need an 
instance of class Math (which> remember, you're not allowed to 
create) . 

The variable is marked final because PI doesn't change (as far as 
Java is concerned). 

There is no other way to designate a variable as a constant, but 
there is a naming convention that helps you to recognize one. 
Constant variable names should heinaU caps! 



Initialize a finBl static variable: 
^ At tha time you declare it: 

pi:blic class 7oo { 

public static final int ¥O0_X 



= 25; 



OR 



Xn o static Initializer: 

public class Bar { 

public fltstic final double HMlSIGK; 



If you don t give a value to o fnal variable 
in one of those two places: 

public class Bar { 

public fltatLic final double aAR_SIGN; 



) 



ho 



Oh 



The compiler will catch it: 



Edit Wirnlow H«f& JacWn 




BAR SIGN - (double) Math.randomO ; 
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% javac Bar.java 

Bar.java:!: variable BAR_SIGN 
might not have been initialized 

1 error 
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final isn't Just for static 
variables... 

You can use the keyword final to modify non- 
static variables too, including instance variables, 
local variables, and even method parameters. In 
each case, it means the same thing: the value can't 
be changed. But you can also use final to stop 
someone from overriding a method or making a 
subclass. 



non-static final variables 

. you t tViSrv^c M 



class Foot { 

final int size = 3; 
final int whuffie ; 



FoofO { 



> 



whuffia = A2;t^ y,o>h ^ou t^n 



r 



void doStuff (final int x) ( 
// you can't chang« x 

) 

void doMoreO ( 
final int z = 7; 
// you can' t chang« z 



nal method 

class Poof ( 

final void calcWhuffia () ( 
// in^rtant things 
// that muat n«var b* ovarriddan 



lal class 

final class MyMOstF«r£«etClass ( 

// cannot be sxt«nd«d 
) 



A final variatlc means you 
can't dtan^e its value. 

A final metkoct means you 
can't overriJe tke metkocL 

A final class mcan5 you 
can't extend tke class (i.e. 
you can't make a sukclass). 
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A static mftthod can't access a 
non-statk variabte. But can a non-static 
method access a static variable? 

A- 

-Tl* Of course. A non-static method in a 
class can always call a static method in the 
ciass or access a static variable of the class. 



Why would I want to make a class 
final? Doesn't that defeat the whole 
purpose of 007 

A- 

Yes and no. A typical reason for 
making a class final is for security. You 
can%for example, make a subclass of the 
String class. Imagine the havoc If someone 
extended the String class and substituted 
their own String subclass objects, 
polymorphlcally, where String objects 
are expected. If you need to count on a 
particular Implementation of the methods 
In a clasS; make the class final. 



Isn't it redundant to have to mark 
the methods final If the class Is final? 

A- 

If the class is final, you don't need to 
mark the methods finaLThink about It— if 
a class Is final it can never be subclassed, 
so none of the methods can ever be 
overridden. 

On the other hand. If you do want to allow 
others to extend your class, and you want 
them to be able to override some, but not 
ad, of the methods^ then don't mark the 
class final but go in and selectively mark 
specific methods as final. A final method 
means that a subclass can't override that 
particular method. 



BULLET POINTS 

■ A static method should be called using the cisss 
name rather than an object reference variable: 
MAth , random 0 vs. nyFoo . go ( ) 

■ Astatic method can be invoked without any instances 
of the method's class on the heap. 

■ A static method is good for a utility method that does 
not (and will never) depend on a particular instance 
variable value. 

■ A static method is not associated with a particular 
instance— only the class— so It cannot access any 
instance variable values of tts class. It wouldn't know 
which instance's values to use. 

■ A static method cannot access a non-static method, 
since non-static methods are usually associated with 
instance variable state. 

■ If you have a class with only static methods, and you 
do not want the dass to be Instantiated, you can mark 
the constnjctor prh/ate. 

■ A static variable Is a variable shared by all members 
of a given dass. There is only one copy of a static 
variable in a class, rather than one copy per each 
individual instance for instance variables. 

■ A static method can access a static variable. 

■ To make a constant in Java, mark a variable as both 
static and final 

■ A final static variable must be assigned a value either 
at the time it is declared, or in a static initializer, 
static ( 

DOG_CODE = 420; 

} 

■ The naming convention for constants (final static 
variables) is to make the name all uppercase. 

■ A final variable value cannot be changed once It has 
been assigned. 

■ Assigning a value to a final Instance variable must be 
either at the time !t Is declared, or in the constructor. 

■ A final method cannot be overridden. 

■ A final dass cannot be extended (subdassed). 
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^pen your pencil 



What's Legal? 

Given everything you've just 
learned about static and final, 
which of these would compile? 




public claaa Foo { 
static int x; 

public void go() { 

Syfltam.out.println(x) ; 

) 



public clasa Foo4 { 

static final int it = 12; 

piablic void go() ( 

Syatam. out .pr intln<x) 

) 



public claas roo2 ( 
int x; 



public static void go() { 
Syatem. out ,printLln (x) ; 

) 



public class Foo5 ( 

static final int x = 12; 

public void go (final int x) { 
System. out,println(x) ; 



public class Foo3 { 
final int x; 

public void go() { 

Syst«ni,out.println(x) ; 

} 



public class F006 ( 
int X = 12; 

public static void go (final int x) 
System. out. println{x) ; 

) 
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Math methods 



Now that we know how static 
methods work, let's look 
at some static methods in 
class Math. This isn't all of 
them, just the highlights. 
Check your API for the rest 
including sqrt(), tan(), ceil(), 
floorO, and asin(). 



Math.randomO 

Returns a double between 0.0 through (but 

not including) 1.0. 

doxible rl ^ Math.randO!m() ; 

int r2 = (int) (Math.randomO * 5) ; 



Returns a double that is the absolute value of 
the argument. The method is overloaded, so 
if you pass it an int it returns an int. Pass it a 
double it returns a double. 

int X = Math.abs(-240) ; // returns 240 

double d = Math.abs (240 .45) ; // returns 240.45 

Math.roundQ 

Returns an int or a long (depending on 
whether the argument is a float or a double) 
rounded to the nearest integer value. 

int X = Math.round(-24.8f) ; // returns -25 
int y = Math. round (24. 45f ) ; // returns 24 



Returns a value that is the minimum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles, 
int X = Math.min(24,240) ; // returns 24 

double y = Math. min (90876. 5, 90876.49); // returns 90876.49 



Math.maxO 

Returns a value that is the maximum of the 
two arguments. The method is overloaded to 
take ints, longs, floats, or doubles, 
int X = Math. max(24, 240) ; // returns 240 

double y = Math.max(90876.5, 90876.49); // returns 90876.5 



Math.absO 



"to be doubles uy»lesj 




Math.minO 
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Wrapping a primitive 

Sometimes you want to treat a primitive like 
an object For example, in all versions of Java 
prior to 5.0» you cannot put a primitive directly 
into a collection like ArrayList or HashMap: 

int X = 32; 

Arrayliist list = new Arrayl*ist() ; 
list, add (x) 

T^is wm-k u.l«s yo^'« Oawa 



tKat U^t object rtWyv^", J 



There's a wrapper class for every^ primitive type, 
and since the wrapper classes are in the Java, 
tang package^ you don't need to import them. 
You can recognize wrapper classes because 
each one is named after the primitive type it 
wraps, but with the Rrst letter capitalized to 
follow the class naming convention, 

Oh yeah» for reasons absolutely nobody on the 
planet is certain of, the API designers decided 
not to map the names fix^rtify from prhiudve 
type to class type. You*ll see what we mean: 



Boolean 
Character 
Byte 
Short 
Integer 
Long 
Float 
Double 

wrapping a value 

int i = 288; 



VVaUV* c^u-t' TKe ^^^^ 

iy^^ Vht ddis art HllNf 



Integsr iWrap = n^w Inb»ger(i); 

All {y^t wraijT>e%^ vjotlt 



u/rwrapplng a value ^ 

int unwrapped = IWrap . intValu« ( ) ; 




primitive 



you need to treat 
a primitive like an otject, 
wrap it. H you're using any 
version ol Java Lefore 5.0, 
you 11 Jio tkis wlien you 
need to store a primitive 
value inside a collection like 
ArrayList or HaskMap. 




Note: the picture at the top is a chCMiolate In a foil vvrBpi>er. Get 
tr? Wrapper? Some people thfnk it looks like a baked potato, but 
that works too. 



you are here * 287 



static methods 



Thrs is stupid. You mean I ca 
just make on ArrayU^ of ints??? I 
have to wrap every single f rickin' one in a new 
Integer object, then unwrap it when I try 
to access that value in the ArroyList? 
Thaf s a waste of time and an error 
. waiting to happen... 



Fef ore Java 50, YOU had to do the work... 

She*s right In aU versioas of Java prior to 5.0, primitives were primitives 
and object references were object references, and ihey were NEVER 
treated interchangeably. It was always up to you, the programmer, to do 
the wrapping and unwrapping. There was no way to pass a primitive to a 
method expecting an object reference, and no way to assign the result of a 
method reluming an object reference directly to a primitive variable — even 
when the returned reference is to an Integer and the primitive variable is 
an inL There was simply no relationship between an Integer and an int, 
other than the fact that Integer has an instance variable of type ini (to hold 
the primitive the Integer wraps). All the work up to you. 



An ArrayList of primitive ints 



Without autoboxing (Java versions before 5.0) , . l 

PU.UC voi. .«»»S0U»,,„ , «f;t;\£'^^^t2$^i^'^*' 

ArrayList lifltOfNumbers = new ArrayList (); , . 

/ 't add tV^« ?-'-^^' ^ 
listOfNianbers . add (new Integer (3) ) ; ^ Vo" , -.^ m l^ti^'*' ^'^"'^ 



SO ^OM 

Xntager one = (Integer) listOfNumbers ,get (0) ; 
int intone - one , intValue ( ) ; 



Ofeytt t"-t7*- 
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Autoboxing: blurring the line 
between primitive and object 

The autoboxing feature added to Java 5.0 does 
the conversion from primitive to wrapper object 
automatically! 

Let's see what happens when we want to make an 
ArrayList to hold ints. 

An ArrayList of primitive ints 

lYfth autoboxing (Java versions 5.0 or greater) 



public void doNumsNewWay { ) { Make a*^ 

ArrayList<Integer> lis to f Numbers = new ArrayList<Integer> ( ) ; 

listOfNumbers . add (3) ; Jus^ add \il AltKoujh iWe is HOT a mctKod in A^ayList 

•fo^ addCint), -tKg iiomptlcv docs ail the wvafpinj 

int num = listOfNumbers .get (0) ; (kox^in^) -fov yos*^ othcv- words, -tKcirc really [S 

} ^ an In-be^ev" objeit't stored in tKe ArrayLisi> but 

And -f k / i i you jct to V^'tc'^d'' t^^'t ^« Av^'f^^yi-ist takes 

Ik. 11 ^^C^"" f'^^^^t^W'i unwraps (unboxes) '^"ts^ (^ou dan add botb ints and Integers to an 

dte tt^^^^ y^.^^^ valJ /W.ayUst<fnte5er>.) 

^ method on the Integer object 



Why not declare an ArrayLi$t<mt> if you want to 
hold ints? 

A- 

Because,.. you can't Remember, the rule for generic 
types is that you can specify only class or interface types, not 
primitives. So ArrayList<int> will not compile. But as you can 
see from the code above, it doesn't really matter, since the 
compiler lets you put ints into the ArrayList<Integer>. In fact, 
there's really no way to prevent you from putting primitives 
into an ArrayList where the type of the list is the type of that 
primitive's wrapper, If you're using a Java 5.0-compliant com- 
piler, since autoboxing will happen automatically. So, you can 
put boolean primitives in an ArrayList<Boolean> and chars 
into an ArrayList<Character>. 
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AutoboxiHQ works almost everywhere 

Autoboxing lets you do more than just the obvious wrapping and 
unwrapping to use primitives in a collection... it also lets you use 
either a primitive or its wrapper type virtually anywhere one or the 
other is expected. Thijik about thati 

Fun with autoboxing 



Method arguments 

If a method fakes a wrapper type, you 
can pass a reference to q wrapper or 
o primitive of the matching type. And 
of course the reverse is true— »f a 
method takes a primitive, you can 
pass in either a compatible primitive 
or a reference to o wrapper of that 
primitive type. 




void takeNumber (Integer i) { } 



Return values 

If a method declares a primitive 
return type, you can return either a 
compatible primitive or a reference 
to the wrapper of that primitive type 
And if a method declares a wrapper 
return type, you can return either a 
reference to the wrapper type or a 
primitive of the matching type. 



int giveNujnber (} { 
return x; 




Boolean expressions 

Any place a boolean value is ej^pected, 
you can use either an expression that 
evaluates to a boo/ean (4 > 2), or a 
primitive boolean, or a reference to a 
Boolean wropper 




txue 



boolean 



System. out.pr in tin ("true") ; 
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Operations on numbors 

This IS probably the strangest one— yes, you 
can now use a wrapper type os an operand 
in operations where the primitive type is 
expected. That n^eons you can appfy, say. 



the increment operator against o reference x%iMiF & I 1 



to an Integer object) ^^^^^ 

Bat don't worry— this is just a compiler trick. 
The language wasn't modified to make the 

operators work on objects; the compiler , 
simply converts the object to its primitive 
type before the operation. It sure looks 
weird, though. 

Integer i - new Integer(42); 

And that means you can also do things like: 

Integer j = new Integcr(5); 
Integer k = j ^ 3; 

Assignments 

You can assign either a wrapper or primitive 
to a variable declared as a matching wrapper 
or primitive. For example, a primitive int 
variable can be ossigmd to an Integer 
reference variable, and vice-verso— a 

reference to an Integer object can be Double d ="V^ 

assigned to a variable declared as an int 
primitive. 




4^^pen your pencil 



will this code compile? Will It mn? If it runs, 
what will It do? 

Take your time and think about this one; it 
brings up an implication of autoboxing that 
we didn't talk about. 

You'll tiava to go to your compiler to find 
the answers. (Yes» we're fordng you to 
experimanl, for your own good of course.) 



public clua TastBox ( 

Int«g«r i; 

int j; 

public atatia void main (String!] arga) ( 
TestBox t = naw T«5tBcx() ; 

t.goO ; 

} 

public void go() { 

j-i; 

Syatam.out.println ( j) ; 
Syatam.out.println(i) ; 

) 
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?ut wait! There's more! Wrappers 
liave static utility methods too! 

Besides acting like a normal class, the wrappers have a 
bunch of really useful static methods. We've used one m 
this book before — Integer.parselnt(). 

The parse methods take a String and give you back a 
primitive value. 

Converting a String to a ^^y^ U 

primitive value Is easy: ^i" \nio 

string s = ^^2'^' 
int X = Integer ,parfielnt(s) ; 
double d = Double. parsaDouble (''420 . 24") 



boolean b = new Boolean true") ,booleanValu© () ; 

v^'d tw..k I'f^i^'i s,<.^. M 



But if you try to do this: 

string t = ^^two^'; 
int y = Integer .paraelnt(t) ; 



UK-oK. Th\s dompilcs jus{, (]Y,Ct but 

\L at ^runtime it blows up. Ar^ythi^^g 
i^iSi Uni b« pavscd 5i a number- 
will t^ijst a Kui^bev^Foy-matBTiicption 



YouUI get a runtime exception: 



Every method or 
constructor that parses 
a Siring can throw a 
NumberFormatExceptlon. 
it's a runtime exception, 
so you donH have to 
handle or declare it. 
But you might want to. 

(We'll talk about Exceptions in the 
next diapter.) 



% java Wrappers 

Exception in thread ''main" 

java . lang . NumberFormatException : two 

at java , lang . Integer . par seint (Integer . java : 4 09) 

at java . lang . Integer . par seInt (Integer , java : 4 58) 

at Wrappers . main (Wrappers . java ; 9) 
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And HOW in reverse... turniHg a 
primitive number into a String 

There are several ways to rum a number into a Strmg. 
The easiest is to simply concaJtenate the number to an 



String doubleStrirvg 



double d = 42.5; 

String doubloStxing = DotiblG . toString (d) ; 
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Number formatting 



In Java, formatting numbers and dates doesn't have to be coupled with I/O. Think 
about it. One of the most typical ways to display numbers to a user is through a 
GUI. You put Strings into a scrolling text area, or maybe a table. If formatting was 
built only into print statements, you'd never be able to format a number into a nice 
String to display in a GUI. Before Java 5.0, most formatting was handled through 
classes in the java.text package that we won't even look at in this version of the 
book, now that things have changed. 

In Java 5.0, the Java team added more powerful and flexible formatting through a 
Formatter class injava.util. But you don't need to create and call methods on the 
Formatter class yourself, because Java 5.0 added convenience methods to some of 
the I/O classes (including printf()) and the String class. So it's a simple matter of 
calling a static String.format() method and passing it the thing you want formatted 
along witii formatting instructions. 

Of course, you do have to know how to supply the formatting instructions, and 
that takes a littie effort unless you're familiar with the printfO function in C/C++. 
Fortunately, even if you ^on'^ know printf() you can simply follow recipes for the 
most basic things (that we're showing in this chapter) . But you willw^nt to learn 
how to format if you want to mix and match to get anything you want. 

We'll start here with a basic example, then look at how it works. (Note: we'll revisit 
formatting again in the I/O chapter.) 



Formatting a number to use commas 



public class TestFormats { 



public static void main (String[] args) 




String s = String . format , d", 1000000000); 




»« number-. 
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Formatting decoHstructed... 

At the most basic level, formatting consists of two main parts 
(there is more, but we'll start with this to keep it cleaner): 



Formatting Instructions 

You use special format specifiers that describe liow 

the argument should be formatted. , i^t^O 

The argument to b«<brmatt«l. ^Z^'^^}"^'^ '^'" 

Although there can be more than one argument, we*ll tave^ull^f. 
start with just one. The argument type can't be just 
anything... it has to be something that can be fomaatted 
using the fomnat specifiers in the formatting instmctions. 
For example, if your fonnatting instmctions specify a 
floating point number, you can't pass in a Dog or even a 
String that looks like a floating point number. 

po tW** *' ^ this. 

format(^^%, d", 1000000000); 



r 



\ 



Use tliese instructions... on this argument. 



What do these instructions actually say? 

"Take the second argument to this method, and 
format it as a decimal integer and insert commas*'' 

How do they say that? 

On the next page we'll look in more detail at what the syntax 
d" actually means, but for starters, any time you see the percent 
sign (%) in a format String (which is always the first argument 
to a formatO method), think of it as representing a variable, 
and the variable is the other argument to the method. The rest 
of the characters after the percent sign describe the formatting 
instructions for the argument. 
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The percewt l^) says, "insert argument here" 

(and format it using these instructions) 

The first ar^ment to a formatO method is caJled the format String, and it 
can actually include characters that you just want printed as-is, without extra 
formatting. When you see the % sign, tJiough, think of the percent sign as a 
variable that represents tl^e other argument to the method, 



c^..^^^^^^t\ 

fonnat(^^I have %T2f bugs to fix."; 476578,09876); 



Outfit 



I have 476578.10 bugs to fix. 



Tlie sign tells the formatter to insert the other method argument (liie 
second argument to formai(), Uie number) here, AND format it using tJie 
\2r characters after the percent sign. Then the rest of the format String, 
'bugs to iix", is added to the final output. 



Adding a comma 

format (^^I have %,,2f bugs to fix,'\ 476578.09876}; 



I have 476,57fi,10 bugs to fix. 
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But how docs it even KNOW 
where the instructions end and the 
rest of the chorocters begin? How come 
it doesn't print out the "f " in "%.2f "? Or 
the "2"? How does it know that the .2f 
was port of the instructions ond NOT^ 
port of the String? 



The format Striwg uses its 
own little language syntax 

You obviously can't put ju5t anything z£i^r the ""fc^ 
sign. The syntax for what goes after tl^e percent 
sign follows very- specific rules^ and describes 
how to formal the argument iJiat gets inserted at 
that point in the result (formatted) String. 

You've already seen two examples: 

%, d means ''insert commas and format the 
number as a decimal integer." 

and 

%.2f means ''format die number as a floatu>g 
point with a precision of two decimal places." 

and 

%,.2f means ''insert commas and format die 
number as a floadng point w^th a precision of 
two decimal places." 

The real question is really, "How do I know what 
to put after the percent sign to get it to do what 
I wanL^"* And that includes knowing the s^Tubois 
(like ''d'' for decimal and "F for floating point) 
as well as d>e order in which die instructions 
must be placed follo\^nng the percent sign. For 
example, if you put the comma after the ^^d" like 
this: "%d>" instead of *'%,d*' it won'i workl 

Or will it? What do you think Uiis \vi]\ do: 

String, format ("I have %.2f, buga to fix.", 476578.09676); 

(We'll answer that on the next page.) 
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The format specifier 



Everything after the percent sign up to and including the type indicator (like 
"d" or "r) are part of the formatting instructions. After the type indicator, the 
formatter assumes the next set of characters are meant to be pan of the output 
String, until or unless it hits another percent (%) sign. Hmmrnm... is that even 
possible? Can you have more than one formatted argument variable? Put that 
thought on hold for right now; we'll come back to it in a few minutes. For now, 
let's look at the syntax for the format specifiers — the things that go after the 
percent (%) sign and describe how the argimient should be formatted. 

A format specifier can have up to five different parts (not 
Including the Everything In brackets [ ] below is optional, so 
only the percent (%) and the type are required. But the order Is 
also mandatory, so any parts you DO use must go In this order. 

% [argument number] [flags] [width] [ -precision] type 



% [argument number] [flags] [width] [ .precision] type 





format ("% , 6 . If 



4 2.000); 
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The only required specifier is for TYPE 

Although type is the only required specifier, remember that if you do put 
in anything else, type must always come last! There are more than a dozen 
different type modifiers (not including dates and times; they have their own 
set), but most of the time you'll probably use %d (decimal) or %f (floating 
point). And typically you'll combine %f with a precision indicator to set the 
number of decimal places you want in your output. 



The TYPE is mandatory, everything else is optional. 

%d dBclmal n/^"^ I\ ^11^ 

format (-%d'\ 42) ; would be iClt T*^' 



The argument must be compatible with an int, so that means 
only byte, short, int, and char (or their wrapper types). 



%f floating point 

format . 3t" , 42 .000000) 



42.000 



so we ervdea -^'t** 



The argument must be of a floating point type, so that 
means only a float or double (primitive or wrapper) as well 
as something called BigDecimal (which we don't look at in 
this book) . 



You must inclu Je a 
type in your f omat 
instructions, and il you 
specify tkingfs l>esictes 
type, tke type must 
always come last . 
Most ol tke time, 
you'll prokakly format 
numkers using eitker 
"cT' ior decimal or "f" 
for floating point. 



%x hBxadocimal 

format ("%X", 42); 



2a 



The argument must be a byte, short, int, long (including 
both primitive and wrapper types), and Biglnteger. 



%c charactBT 

format ("%C", 42) ; 



6Kdr ' 



The argument must be a byte, short, char, or int (including 
both primitive and wrapper types). 
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What happens if I have more than one argument? 

Imagine you want a String that looks like this: 
"The rank is 20,436,654 out of 100,567,890,24^ 

But the numbers are coming from variables. What do you do? You simply add two 
arguments after the format String (first argument), so that means your call to format() 
will have three argimients instead of two. And inside that first argxnnent (the format 
String), you'll have two different format specifiers (two things that start with "%"). The 
first format specifier will insert the second argument to the method, and the second 
format specifier will insert the third argument to the method. In other words, the 
variable insertions in the format String use the order in which the other arguments are 
passed into the format () method. 



int one - 20456654; 
double two - 100567890.248907; 

String s ^ String . format ( ''The rank is %^d out of %,.2f'\ one, two); 




The rank is 20,456,654 out of 1 



We added domynas to bo-fcK variables, 
and rtsir\ticd iKe -flodtm^ ^omt 
mtrhcr stCot\d variable) io i^o 




1,567,890.25 



you have ^ore iha. 



As you'll see when we get to date formatting, you might actually want to apply different 
formatting specifiers to the same argument. That's probably hard to imagine until you 
see how <ia^^ formatting (as opposed to the wwwi^^ formating we've been doing) works. 
Just know that in a minute, you'll see how to be more specific about which format 
specifiers are applied to which arguments. 

Um, there's something REALLY strange going on here. Just how many arguments can I 
pass? I mean, how many overloaded formatO methods are IN the String class? So, what happens 
if 1 want to pass, say, ten different arguments to be formatted for a single output String? 

A- 

Good catch. Yes, there is something strange (or at least new and different) going on, and 
no there are not a bunch of overloaded formatO methods to take a different number of possible 
arguments. In order to support this new formatting (printf-like) API in Java, the language needed 
another new feature— var/o6/e argument lists (called varargs for short). We'll talk about varargs 
only in the appendix because outside of formatting, you probably won't use them much In a well- 
designed system. 
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So much for numbers^ what about dates? 



Imagine you want a String that looks like this: "Sunday, Nov 28 2004" 

Nothing special there, you say? Well, imagine that all you have to start with is a variable 
of type Date — Java class that can represent a timestamp, and now you want to take that 
object (as opposed to a number) and send it through the formatter. 

The main difference between number and date formatting is that date formats use a 
two-character type that starts with "t" (as opposed to the single character "F or "d", for 
example) . The examples below should give you a good idea of how it works: 

The complete date and time %tc 

string, format (''%tc'% new Date () ) ; 



Sun Nov 28 14:52:41 MST 2004 



Just the time %tr 

string. format ("%tr", new Date () ) ; 



03:01:47 PM 



Day of the week, month and day 



%tA %tB %td 



There isn't a single format specifier that will do exacdy what we ^ 

want, so we have to combine three of them for day of the week "t^i ^€ay\s wc H<5vc 4- 

(%tA), month (%tB), and day of the month (%td). ^^ie oh\tci m ik 

Date today = new Date ( ) ; wo^l^^^^^ /n oC 
string . format ( "%tA, %tB %td" , today, today, today) ^{^^ d^y^ 3'^« w jusi 

Ut to£!i is «oi paH: ihe Ur^iihrA- ii's ^Vll' ^ ^f^'^^^i^t ZT 

just tKe dharadtcv we want pointed i^ht^ tKe "il J^l/"*"^ ^9^* Wk. 

t.«t inserted U^iiitA ir\u».tf,i. '^^■'^ -ontH. ^ 



Sunday, November 28 



Same as above, but without duplicating the arguments %tA %tB %td 

Date today = new Date ( ) ; TKe anjte-bratket "<" is jwt anotKe»- 

String. format ("%tA, %<tB %<td", today) ; f ^9 )J^< fP«'^i<>; iHat telU tKe 

+<»T*,attev to use the pvevious airawwent 
Vou Mn tKink of tKis as kind of like tailing iWet ^5^"* " ^ .Y*^ ^Tom »-epcat\n^ tKe 

di+Wnt jette*- -.etKods en tKe Date objeti to arju^ents, and instead vou -i-orwat tKe 

set tKvee diWe»-ent pieiuis of data f *-o«> it ^""^ arjw^ent tKvee di+fercnt ways. 
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Working with Pates 

You need lo do more with dates than just gel 
today's dzie. You need your programs to adjust 
dates, find elapsed dmes, prioritize schedules, 
heck, make schedules. You need industrial 
strength date manipuJadon capabilities. 

You could make your own date roudnes of 
course... (and don*t forget about leap yearsi) 
And, ouch, those occasional, pesky leap- 
seconds. Wow, this could get complicated. The 
good news is that the Java API is rich with 
classes chat can help you manipulate dates. 
Sometimes it feels a little too rich... 
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Moving backward and forward In time 

Let's say your company's work schedule is Monday through Friday. 
You've been assigned the task of figuring out the last work day in 
each calendar month this year... 

It seems that java.util.Date Is actually... out of date 



For a time-stamp ol ^ now"^ 
use Date* But lor eveiytlimg 



Earlier we used java.util.Date to find today's date, so it seems . ri i t 

logical that this class would be a good place to start looking for else^ USe l/aLeilclar« 

some handy date manipulation capabilities, but when you check 
out the API you'll find that most of Date's methods have been 
deprecated! 

The Date class is still great for getting a "time stamp" — ^an object 
that represents the current date and time, so use it when you want 
to say, "give me NOW". 

The good news is that the API recommends java.util.Calendar 

instead, so let's take a look: 



Use Java.util.Calendar for your date manipulation 

The designers of the Calendar API wanted to think globally, 
literally The basic idea is that when you want to work with dates, 
you ask for a Calendar (through a static method of the Calendar 
class that you'll see on the next page), and the JVM hands you back 
an instance of a concrete subclass of Calendar. (Calendar is actually 
an abstract class, so you're always working with a concrete subclass.) 

More interesting, though, is that the /tmc? of calendar you get 
back will be appropriate for your locale. Much of the world uses the 
Gregorian calendar, but if you're in an area that doesn't use a 
Gregorian calendar you can get Java libraries to handle other 
calendars such as Buddhist, or Islamic or Japanese. 

The standard Java API ships with java.util.GregorianCalendar, so 

that's what we'll be using here. For the most part, though, you 
don't even have to think about the kind of Calendar subclass you're 
using, and instead focus only on the methods of the Calendar class. 
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getting a Calendar 

letting an object that extends Calendar 

How in the world do you get au "instance" of an abstract class? 
Well you don't of course, this won't work; 



This WONnr work; \^ 

Calendar cal = new Calendar () ; 



TVt dompilcv VJOh't allow -tKii/ 



Instead, use the static ^getlnstanceO" methods 

Calendar cal = Calendar .get Instance <) ; 




Tliii sytstaTt sKould look -f dt«iliar at IWis 



You can't get an instance of Calendar, 
but you can can get an instance of a 
concrete Calendar subclass. 



Obviously you can*L get an instance of Calendar, because 
Calendar is abstracL But you're still free to call static methods 
on Calendar, since ^^/i^ methcwis are called on the clasSy 
rather than on a particular instance. So you call the static 
getlnstanceO on Calendar and it gives you back... an instance 
of a concrete subclass. Something that extends Calendar 
(which means it can be polymorphically assigned to Calendar) 
and which — by contract — can respond to the methods of class 
Calendar. 

In most of the world, and by default for most versions ofjava, 
you'll be getting back a java.utU.GregorianCalendar instance. 
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Working with Calchdar objects 

There are several key concepts you'U need to understand in 
order to work with Calendar objects: 

* fields hold state- A Calendar object has many fields that aire used to 
represent aspects of its ultimate stjate» its date and time. For instance, you 
can get and set a Calendar's year or monlK 

■ Dates and Times can be incremented - The Calendar class has methods that 
allow you to add and subtract values from various fields, for example "add 
one to the month", or "subtract three years'". 

■ Dates and Tiraes can be represented in miUiseconds - The Calendar class 
lets you convert your dates into and out of a millisecond representation. 
(Specifically, the number of miUiseconds that have occured since January 
1st, 1970.) This allows you to perform precise calculations such as "elapsed 
dme between two times'" or "add 63 hours and 23 minutes and 12 seconds 
to this time"*. 



An example of working with a Calendar object: 

Calendar c = Calendar .getlnstance () ; ^ Set t»"^* ^ 

C.S*t(2004,0,7,15,40) ; 4, ^ Co.v«^; ^ ^T^' 

long dayl = getTimelnMillia () ; 

dayl 1000 * 60 * 60; 

k 



- tm^u k}.t ^+^^ it'^ \\\^t day) ^ dayl + ...)■ 



c. setTdLmelnMillifi (dayl) ; 
System, out .println (''new hour " + c.get (c. HOtIR_OF_DAY) ) 

c.add(c.DATE/ 35) ; 

System. out. println (''add 35 days " + c, getTima () ) ; 
c. roll (c, DATE, 35); — 



Add 3*5 day$ tiic dal^, w^ii^K 



System^out .println (''roll 35 days + c. getTime () ) / 
c . set (c . DATE , 1 ) ; ^ ^ 



System, out , print In ("set to 1 



+ c .getTime () ) ; 

1 



"/?oH" 55 onio -Uii diit. nil 



add 35 days Wed Feb U U:40;J1 MST 2004 
roil 35 days Ty€ Feb M UAQiU MST 2004 
5et to 1 Sun Feb 01 16:40:U MST 2004 



addj v^ll/ ^^d set v^ork. 
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Highlights of the Calendar API 

We just worked through using a few of the fields and 
methods in the Calendar class. This is a big API so 
we Ve showing only a few of the most common fields 
and methods that you^ll use. Once you get a few of 
these It should be pretty easy to bend the rest of the 
this API toyourwiU, 



Key Calendar Methods 



adddnt field, int amount) 

Adds or subtracts time from the calendar's field. 

get(int field) 

Returns the value of the given calendar field. 

getlnstanceO 

Returns a Calendar, you can specify a locale. 

getTfmelnMUIIsO 

Returns this Calendar's time In mlllls, as a long. 

roH(int field, boolean up) 

Adds or subtracts time v^^lthout changing larger fields. 

set((nt field, int value) 

Sets the value of a given Calendar field. 

set(year, month, day^ hour, minute) (all ints) 

A common variety of set to set a complete time. 

setTimelnMillisdong miilis) 

Sets a Calendar's time based on a long mllli-time. 

// more... 



'f^yCa/endarFfe/ds 

'/^et the day of month 

"OUR/HOUR _0F DAY 

Get/seftheOh" 

MINUTE 

MONTH 

^«/^et the month 
VEAR 

G^tAet the year. 

ZONE^OFFSET 

J^ee/.et..o.seto.GMT,nm,«,. 
'/more... 
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EvcH more Statics!... static imports 

New to Java 5.0... a real mixed blessing. Some people love 
this idea, some people hate iL Static imports exist only lo save 
you some typing. If you hate to type> you might just like this 
feature. The downside to stadc imports is that - if you're not 
careful - using them can make your code a lot harder to read. 

The basic idea is that whenever you're using a static class, a 
static variable, or an enum (more on those later), you can 
import them, and save yourself some typing. 



Soma old-fashioned code: 

import java . lang . Math; 

class NoStatic { 

public static void main (String [) args) { 



Use Carefully: 

static imports can 
make your code 
conhismg to reaJ 



but .println C'sqrt 
put.println (''tan ' 



sqrt(2.0) ) 
tan (60)) ; 



Same code, with static Imports: 

pghprt static j ava . laog , Sysfm , ovU^ 




Cavaofi ft Gotchas 



class WithStatic ( 

public static void main (String [] args) { 



rintinC'sqrt " - 
println (^'tan '' -f 




Pi(2.0)) ; 
m) ) ; 



If you're only going to use a static member 
a few times, we think you should avoid 
static imports, to help keep ttie code more 
readable. 

If you're going to use a static member a lot, 
(like doing lots of Math calculations), then 
ifs probably OK to use the static Import. 

Nodce that you can use wildcards (.*), in 
your static Import declaration. 

A big issue with static imports is that ifs 
not too hard to create naming conflicts. For 
example, if you have two different classes 
with an 'addQ' method, how will you and 
the compiler know which one to use? 
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static vs. instance 



Fireside Ghats 




Tonight's TaJk: An inKtance variable 
takes cheap shots at a static variable 



Imrtanoe Variable 

I don't even know why weVe doing this. 
Everyone knows static variables are just used 
for constants. And how many of those are 
there? I think the whole API must have, what, 
four? And it's not like anybody ever uses 
them. 



Static Variable 



Full of it. Yeah, you can say that again. OK> 
so there are a few in the Swing library, but 
everybody knows Swing is just a special case. 



Ok, but besides a few GUI things, give me an 
example of just one static variable that anyone 
would actually use. In the real world. 



Well, that's another special case. And nobody 
uses that except for debugging anyway. 



You really should check your facts. When 
was the last time you looked at the APP It's 
frickin' loaded witli staticsl It even has endre 
classes dedicated to holding constant values. 
There's a class called SwingConstants, for 
example, that's just fuU of them. 



It might be a special case, but it's a really 
important one! And what about the Color 
class? What a pain if you had to remember the 
RGB values to make the standard colors? But 
the color class already has constants defined 
for blue, purple, white, red, etc. Very handy. 



How's System, out for starters? The out in 
System,out is a static variable of the System 
class. You personally don't make a new 
instance of the System, you just ask the System 
class for its out variable. 



Oh, like debugging isn't important? 

And here s somediing that probably never 
crossed your narrow mind — let's face it, static 
variables are more efficient One per class 
instead of one per instance. The memory 
savings might be huge! 
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Instance Variable Static Variable 

Um, aren't you forgetting something? 

What? 

Static variables are about as un-OO as it gets!! 
Gee why not just go take a giant backwards 
step and do some procedural programming 
while we're at it. 

What do you mean un-OO? 

You're like a global variable, and any 
programmer worth his PDA knows that's 
usually a Bad Thing. 

I am NOT a global variable. There's no such 
thing. I live in a class! That's pretty OO you 
know, a CLASS. I'm not just sitting out there 
in space somewhere; I'm a natural part of the 
state of an object; the only difference is that 
I'm shared by all instances of a class. Very 
efficient 

Yeah you live in a class, but they don't call 
it C/«55-Oriented programming. That's just 
stupid. You're a relic. Something to help the 

old-timers make the leap to java. Alright just stop right there. THAT is 

definitely not true. Some static variables are 
absolutely crucial to a system. And even the 
ones that aren't crucial sure are handy. 



Well, OK, every once in a while sure, it makes 
sense to use a static, but let me tell you, abuse 
of static variables (and methods) is the mark 
of an immature OO programmer. A designer 
should be thinking about object sXztc, not class 
state. 



Why do you say that? And what's wrong with 
static methods? 



Static methods are the worst things of all, 
because it usually means the programmer is 
thinking procedurally instead of about objects 

doing things based on their unique object ^ j ^^.^ ^^^^^^ ^^^^^ 

State 

of an OO design, but just because there are 
some clueless programmers out there... don't 
throw the baby out with the bytecode. There's 
a time and place for statics, and when you 
need one, nothing else beats it. 

Riiiiiight. Whatever you need to tell yourself... 
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be the compiler 



class StaticSuper< 



BE coffl^ileT 

TKe Java file on tiiis page represeirts a 
coiqplete pro^pam- Your job is to play 
compiler arul deternfine defter ^iS 
file will compile. If it won't compile, 
how would yon fix it. and 
if it does coiripile, yvhat 
would be its oirtput? 



static { 

System. out,println{ "super static block"); 

} 




StaticSuper{ 

System. out. print In ( 
"super constructor"); 

> 



} 



public class StaticTests extends StaticSuper { 
static int rand; 

static { 

rand = ( int ) ( Math , random ( ) * 6 ) ; 

System. out. println(''static blocX " + rand); 

> 



If (t compiles, which of these Is 
the output? 



Possible Output 

I Rie Edit Window Help Cling 



%java StaticTests 
static block 4 
in main 

super static block 
super constructor 
constructor 



StaticTests ( ) { 

System. out .println( "constructor" ) ; 

> 



Possible Output 

I nie Edrt Window Hetp aectridty" 



public static void main{ String [] args) { 
System, out . println ( ''in main"); 
StaticTests st - new StaticTests () ; 

> 



%java StaticTests 
super static block 
static block 3 
in main 

super constructor 
constructor 
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This chapter explored the wonderful, static, world 



of Java. Your job is to decide whether each of the 
following statements Is true or false. 

1. To use the Math cla&s, the first step is to make an instance of it. 

2. You can mark a constructor with the static keyword. 

3. Static methods don't have access to instance variable state of the 'this' object. 

4. It is good practice to call a static method using a reference variable. 

5. Static variables could be used to count the instances of a class. 

6. Constructors are called before static variables are initialized. 

7. MAX_SIZE would be a good name for a static final variable, 

8. A static initializer block runs before a classes constructor runs, 

9. If a class is marked final, all of its methods must be marked final. 

10. A final method can only be overridden if its class is extended. 

11. There is no wrapper class for boolean primitives- 

12. A wrapper is used when you want to treat a primitive like an object 

13. The parseXxx methods always return a String, 

14. Formatting classes (which are decoupled from I/O), are in the java.format 
package. 
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code magnets 



Ail 




Lunar CoJe Magnets 



This one might actually be useful! In addition to what youVe learned in the last few 
pages about manipulating dates, you'll need a little more information... First full 
moons happen every 2^.52 days or so. Second there was a full moon on Jan, 7th, 
2004. Your job is to reconstruct the code snippets to make a working Java program 
that produces the output listed below (plus more full moon dates), (You might not 
need all of the magnets, and add all the curly braces you need.) Oh, by the way, your 
output will be different if you don't live in the mountain time zone. 





% java FuHMoons 












full moot! on Fri Feb 06 


OA 


09 


35 


MST 


2004 


full moon on Sat Mar 06 


16 


3S 


23 


MST 


2004 


full moon on Hon Apr 05 


06 


07 


U 


MOT 


2O04 
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Ej&f cise Solutions 



BE coiD]jxler 

StaticSuper( ) { 

System^ out , println ( 
^'super constructor"); 

} 



StaticSupcr is a constructor, and must 
have ( ) in its signature. Notice that as 
the output below demonstrates, the static 
blocks for both dosses run before either 
of the constructors run. 



Possible Output 

I Fife Edtt Window Help CJIng 



True or False 

1 . To use the Math class, the first step is to False 
make an instance of it. 

2. You can mark a constructor with the key- False 
word 'static*. 

3. Static methods don't have access to aji True 
object s instance variables. 

4. It is good practice to call a sutic method False 
using a reference variable. 

5. Static variables could be used to count the True 
instances of a class. 

6. Constructors are called before static van- False 
ables are initialized. 

7. ?^MX_SIZE would be a good name for a True 
static final variable. 

8. A static initializer block runs before a class's True 
constnactor runs- 

9. If a class is marked final, all of its methods False 
must be marked final. 

10. A final method can only be overridden if False 
its class is extended. 

1 1 . There is no wrapper class for boolean False 
primitives. 

12. A wrapper is used when you want to treat a True 
primitive like an object 

13. The parseXxx methods always return a False 
String. 

14. Formatting classes (which are decoupled False 
from I/O), are in thejava.format package. 



%java StaticTests 
super static block 
static block 3 
in main 

super constructor 
constructor 
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E^Cerciae Solutions 



olaao FullMoons { 



import java .util . * ; 



ionport atAtic java . lang. Syatam. out ; 



Notes on the Lunar Code Magnet: 

You might discover that a few of the 
dates produced by this program are 
off by a day. This asLronomical stuff 
is a Httle tricky, and if we made it 



Btatio int DAY IM = 1000 * 60 * fiO * 24; 



perfect, it would be too complex to 
make an exercise here. 



public Btatic void main (String [] args) { 



Calendar c = Calendar ^getlnatance () ; 



e.aet(2004,0,7,15,40) ; 



Hint: one problem you might uy to 
solve is based on differences in dme 
zones. Can you spot the issue? 



long dayl = c . gatTlmelnMillis () ; 
for (int X =» 0; X < 60; x++) ( 

dayl += (DAY_IM * 2 9,52) 

c . setTimfilnMillis (dayl) ; 

out. println (String, format (''full moon on %tc", c) ) ; 

) 

) 

} 
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Risky Behavior 




Stuff happens. The file isn't there. The server Is down. No matter how 

good a programmer you are, you can't control everything. Things can go wrong, Very wrong. 
When you write a risky methodyou need code to handle the bad things that might happen. 
But how do you knowwh&n a method Is risky? And where do you put the code to hondleihe 
excepf/ona/ situation? So far in this book, we haven't rea/Zy taken any risks. WeVe certainly had 
things go wrong at runtime, but the problems were mostly flaws in our own code. Bugs. And 
those we should fix at development time. No, the problem-handling code we're talking about 
here is for code that you c^j/i'f guaranatee will work at runttme.Code that expects the file to be 
In the right directory, the server to be running, or the Thread to stay asleep. And we have to do 
this now. Because in fh/s chapter, we're going to build something that uses the risky JavaSound 
API. We're going to build a MIDI Music Piayer. 
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building the MIDI Music Player 



Ufs make a Music Machine 

Over the next three chapters, we*H build a few different sound 
applications, including a BeatBox Dnino Machine. In fact, 
before the book is done, we'll have a multi-player version so 
you can send your drum loops to another player, kind of like 
a chat room. You're going to write the whole thing, although 
you caji choose to use Ready-bake code for the GUI parts. 
OK, so not every IT department is looking for a new BeatBox 
server, but weVe doing this to learn more about Java. Building 
a BeatBox is just a way lo have fun w/iiZ^ we're learningjava. 

The fihished ^eati^ox looks something like this; 



eo o 



Cyber BeatBox 



Bass Dmm gQDQftQSBaaaoSBoo 
Closed Hi-Hat saiiBBQliBBaseBBSS 

OpenHi-Hat □□□OQQaGQDOOOOOO 

Acoustic Snare □ □ QQ QQaBSQOO □ QQ O 

Crash cymtMki BQOBQBBBBOBBOBQB 
Hand Clap QBBQOBOOaQQQaOGO 

High Tom □□□□□□□□□□□□□□□□ 
Hi Bongo □□□□□□ G liC □00 S C 
Maracas gjQgjQ SDSO gUOSOSBSO 

whisue □□□□□BoaaaDDGCGa 
Lowconga □ □□ QoosaaasG^u □ □ 

Cowbell □□□□□□□□□□□□□□□□ 

vibrasiap □QOBBBBQQQBGQBOO 
low-midTom □QOOO OBOBBBBBOOB 
HighAgogo BBB C G □ GBQBBC U D □ B 

Open Hi Cong&B£30g(ggOQOBQQ^SSQ 



c 




Tempo IJp^ 
( Tempo D own 



dance beat 



Andy: groove Wl 
Chris: groov62 revised ^ 
Nigel: dance beat 



Put checkmarks in the boxes for each of the 16 'beats\ For exainple, on beat 
1 (of 16) the Bass drum and the Maracas wiU play on beat 2 nothing, and 
on beat 3 the Maracas and Closed Ki-Hat... you get die idea. When you hit 
'Start\ it plays your pattern in a loop until you hit 'Stop\ At any tin:ie, you 
can "capture" one of your own patterns by sending it to the BeatBox server 
(which means any other players can listen to it) . You can also load any of the 
incoming patterns by clicking on the message that goes with it. 



'SUH:' i , ^ti^k 



316 ctisiplerll 



exception handling 



Well start with the basics 

Obviously we've got a few things to leam before the whole 
program is finished, including how to build a Swing GUI, how 
to connect to another machine via networking, and a liide I/O 
so we can send something to the other machine. 

Oh yeah, and theJavaSound API. TAdz^'j where well start in this 
chapter. For now, you can forget the GUl^ forget the networking 
and the I/O, and focus only on getting some MJDJ-generated 
sound to come out of your computer. Ajid don't worry if you 
don*t know a thing about MIDI, or a thing about reading or 
making music. Everytlung you need to leam is covered here. 
You can almost smell the record deaJ. 

the JavaSouHd API 

JavaSound is a collecdon of classes and interfaces added to 
Java starting with version 1 .3. These aren't special add-ons; 
theyVe part of the standard J2SE class library. JavaSound is split 
into two parts: MIDI and Sampled. We use only MIDI in this 
book. MIDI stands for Musical Instrument Digital Interface, 
and is a standard protocol for getting different kinds of 
electronic sound equipment to communicaie. But for 
our BeatBox app, you can tliink of MIDI as a kind of 
sheet music that you feed into some device you can think 
of like a high-tech 'player piano'. In other words, MIDI 
data doesn't actually include any sound, but it does 
include the inslructions that a MIDI-reading instrument 
can play back. Or for anodier analogy, you can think of 
a MIDI file like an HTML document, and the instrument 
that renders the MIDI file (i.e. plays n) is like the Web 
browser. 

MIDI data says whal to do (play middle C, and here's how hard 
to hit it, and here*s how long to hold it, etc.) but it doesn't say 
anything at all about the actual sound you hear. MIDI doesn't 
know how to make a flute, piano, or Jimmy Hendrix guitar 
sound- For the actual sound, we need an instrument (a MIDI 
device) thai can read and play a MIDI file. But the device is 
usually more like an entire band or orchestra of instruments. And 
that instrument might be a physical device, like the electronic 
keyboard synthesi2ers the rock musicians play, or it could 
even be an instrument built entirely m software, bving in your 
computer. 

For our BeatBox, we use only the built-in, software-only 
instrument that you get \\rith Java. It's called a synthesizer (some 
folks refer to it as a software synih) because it cmtles sonnd-^ 
Sound tliat you Jiear. 
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A1(D| dtyi\U k>NOWS Kow ho 

Wad' a MIDI i^d badk 

sovnd^ TVt devid€ mijki 
be d syri-tj^ttiz^ kryboavd or 
sof«c othev kiivd <^ inrbru*ne»it 

UtK play a LOT of di-f-f 

sou«\di ^pia^o, druFnii violii^j 

<rU-)) and all at -tV^e sa-^c 

So a MIDI lilc isrv't \xVt sU^ 
mbdid ^rtr jurt Ofst musidian in 
\)\t batNd — it 6ar\ Kold tVi« 

farb icft l\LL tKc wwi^iarvs 
playiiTk^ i fav-bdulav- 
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but it looked so simple 



First we need a Sequencer 



Before we cam get any sound to play, we need a Sequencer object. The 
sequencer is the object that takes all the MIDI data and sends it to the right 
ijistruments. It's the thing that plays the music. A sequencer can do a lot of 
different things, but in this book, we're using it strictly as a playback device. Like 
a CD-player on your stereo, but with a few added features. The Sequencer class 
is in the javax.sound.midi package (part of the standard Java library as of version 
L3) . So let's start by making sure we can make (or get) a Sequencer object. 



import javax. sotind .midi . * ; 

public class MusioTestl { 

public void plAyO { 

Sequencer sequencer = MidiSystem.gatSequencer () 



System, out. println (^'We got & sequencer"); 

) // close play 



public static void main (String [] args) ( 
MusicTestl mt = new MuaicTestl () ; 
mt.play 0 ; 

) // close main 

} // close class Somcthfiiglj wrong! 



% javac MusicTestl . java 

MusicTestl . java : 13 : unreported exception javax . sound .midi . 
MidiUnavailableException ; must be caught or declared to be 
thrown 

Sequencer sequencer = MidiSystem. getSequencer ( ) ; 

A 

1 errors 
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What happens when a method you want to call 
(probably in a class you dIdHt write) is risky? 



Let's say you want 
to call a method In a 
Class that you d1dn*t 
write. 






yotir code 




you 



doss you 
didn't write 



That method does 
something risky, 
something that might 
not work at runtime^ 




clo^s yoir 
didn't write 



void moo ( ) ( 

if (flerverDown) { 
axplode 0 ; 



} 



> 



You need to know 
that the method 
you're calling is 
risky. 



You then write code 
that can handle the 
failure if It does 
happen. You need to be 
prepared, just in case. 




My mooO 
method will 
explode if the 
server is down. 




Class you 
didn't write 
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^'^eath.nss might so ^rong 

Java's exception-handling merf,, • • 

O" «cepa„„. '^"^fof-poss.bly even r^w^fr > parteuJa, 

^-W*^„K„,„^ '^^P^Wen.U.a.e.^ed 

-"y ".eu,<,d. dee,a«C ""P^O"' Vou find , , 

da throw, clause in the 





© MWKvstem Oawa 2 Platform S£y 1.4.0) 








Forward Sro& .Refftih H(>n« . -:_ Au!ohlI Mail 
























g«tS«juencer 



public static 5oQuortci>r g«tS*qa*ac«r ( ) 




ExcdpUons 



Obiains the defeulf sequencer. 
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exceptJon handling 



The compiler needs to know 
that YOU know youVe calling 
a risky method. 

If you wrap the risky code ia something called a 
try/catch, the coiripiler will relax. 

A uy/ catch block tells the compiler that you 
knawBxi exceptionaj thing couJd happen in the 
method you're calling, and that youVe prepared 
to handle it That compiler doesn't care kcwyou 
handle ii; it cares only that you say you're taking 
care of it 

irnport j avax. sound. midl . *; 

public class MusicTestl { 
public void playO ( 



try { 

Sequencer sequencer = MidiSystem. getSequencer () ; ^ 
System. out. prin tin r'Succeaafully got a sequencer") 
} catch (MidiUnavailableException ex) { 
Systiam.out.printlnC^Bunimer") ; 




} 

) // close play 

public static void main {String [] args) ( 
MusicTestl mt = new MusicTestl () ; 
mt.playO ; 
} // close main 
} // clos» class 
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exceptions are objects 




Throwable 




getMessageO 
prIntStackTraeeO 



Excepttflfi 



lOExcdptian 










Ah exception is an object... 
of type Exception. 

Which is fortunate, because it would be much harder, 
to remember if exceptions were of type Broccoli. 

Remember from your polymorphism chapters that 
an object of type Exception can be an insunce of aiq^ 
subclass of Exception. 

Became an Exception is an object, what you catch is au 
object. In the following code, the catch argument 
is declared as type Exception, and the parameter 
reference variable is ex. 

try { 

// do risky thing .i's ^'^^ '^'^^'T^ 
} catch (Exception ex) { 



// try to recover 



What you write in a catch block depends on the 
exception that was thrown. For example, if a server 
is down you might use the catch block to try another 
server If the file isn't there, you might ask the user 
for help finding it. 
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If It's your coie that catches the exception, 
then whose code throws It? 

You*U spend much more of your Java coding time handling 
exceptions thsin you'll spend creaiingBiid throwing \hem yourself. 
For now, just know that when your code calls a risky method — a 
method that declares an exception — it*s the risky method that 
throws the exception back to you, the caller 

In reality, it might be you who wrote both classes. It really 
doesn*t matter who writes the code... what matters is knowing 
which method throws the exception and which method catches it. 

When somebody writes code that could throw an exception, they 
must declare the exception. 




your CO 



doss with Q 
risky method 



Risky^ exception-throwing code: 



iWoi MUST U\\ n3ie>^c?t-- 

. ^v.at ^^""^ 



public void takeRiskO 
i f ( abandcnAl iHope) { 

inew BadExceptxonO ; 



BadException { 



^ Your code that calls the risky method: 

public void crossFlngers 0 ( 

an<^ j«ct . takeRisk ( ) ; 
} ^^^1 (BadException ex) { 

System. out.printlii C^Aaargh! ") ; 
ex , printStackTrace ( ) ; 

} 



One method Will 

method tkoWs . An 
exception IS alwnyri 
tdrpwn l^ack tp the 
caller. 

tM'QWs lias tP (.leolrife 
tliaf It ml^k throw 
tlie exception. 
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checked and unchecked exceptions 



E^^ej^iow tKat art HOT iubdlass« o( 
R^hf^cBi^tYhcY. av-« thttktd (or by 



Exception 




The compiler checks for everything 
except RuntimeExceptions. 

The compiler guarantees: 

If you thrower) exception in your code you mt/s? declare it using 
tl^e throws keyword in your method declaration. 



If you ca//a method that throws an exception (in other words, 
a method thbt declares it throws an exception), you must 
<3c/f/7ow/€^^ethat you're aware of the exception possibility. 
One way to satisfy the compiler is to wrap the call in a try/catch. 
(There's a second way we'll look at a little later In this chapter) 




O,' Wait just a minutel How come this is the FIRST time 
we've had to try/catch an Exception? What about the 
exceptions I've aiready gotten iilce NuliPointerException 
and the exception for DivideByZero. I even got a 
NumberFormatExcaptlon from the integerparselntO 
method* How come we didn't have to catch those? 

The compiler cares about all subclasses of Exception, 
ur)l€ss they are a special type, RuntimeException. Any 
exception class that extends RuntimeException gets a 
free pass. RuntimeExceptfons can be thrown anywhere, 
with or without throws declarations or try/catch blocks. 
The compiler doesn't bother checking whether a method 
declares that It throws a RuntimeException, or whether the 
caller acknowledges that they might get thai exception at 
runtime. 



C^! I'll bite. WHY doesn't the compiler care about those 
runtime exceptions? Aren't they Just as likely to bring the 
whole show to a stop? 

J^l Most RuntlmeExceptions come from a problem in 
your code logic, rather than a condition that fails at runtime 
in ways that you cannot predict or prevent. You cannot 
guarantee the file is there. You carinot guarantee the server 
is up. But you can make sure your code doesn't index off the 
end of an array (that's what the .length attribute is for). 

You WANT RuntlmeExceptions to happen at development 
and testing time. You don't want to code in a try/catch, for 
example, and have the overhead that goes with it, to catch 
something that shouldn't happen in the first place. 

A try/catch is for handling exceptional situations, not flaws 
m your code. Use your catch blocks to try to recover from 
situations you can't guarantee will succeed. Or at the very 
leasty print out a message to the user and a stack trace, so 
somebody can figure out what happened. 
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BULLET POINK 

A method can throw an exception when something fails at runtime. 

An exception is always an object of type Exception. (Which, as you 
remember from the polymorphism chapters means the object is from a 
class that has Excepfcn somewhere up its inheritance tree.) 

The compiler does NOT pay attention to exceptions that are of 
type RuntlmeException. A RuntimeException does not have to be 
declared or wrapped in a try/catch (although you're free to do either or 
both of those things) 

All Exceptons the compiler cares about are called 'checked 
exceptions" which really means comp//er-checked exceptions. Only 
RuntimeExcGptions are excluded from compiler checking. All other 
exceptions must be acknowledged in your code, according to the 
mles. 

A method throws an exception with the keyword throw, followed by 
a new exception object: 

throw naw NoCaf fdineException () ; 

Methods that might throw a checked exception must announce it with 
a throws Exception declaration. 

If your code calls a checked-exception-throwing method, rt must 
reassure the compiler that precautions have been taken. 

If you're prepared to handle the exception, wrap the call In a try/catch, 
and put your exception handling/recovery code in the catch block. 

If you're not prepared to handle the exception, you can still make the 
compiler happy by officially 'ducking' the exception. We'll taik about 
ducking a Me later in this chapter. 



4^^rpen your pencil 



Whkh of these do you think 
might throw an exception that 
the compiler would care about? 
We're only looking for the 
things that you can't control In 
your code. We dfd the first one. 

(Because It was the easiest.) 



,^fttaco€H?ttvc tip 

before golt\a lo siaep- ^ ^^^u 

away from it don U^^^^^^ 
challenging than J^cJ o^ what 

Java might not 'st'Ck. 

w^aen'l rule oul learning 

^ probably won't affect your 
Java leamiriQ. 

,or the best results rea^^^^^^^^ 

book (or at least look 
Ts U^es) right betore 

Qoir\g to sleep. 



Things you want to do 

V^connect to a remote server 

_ access an array beyond its length 

display a window on the screen 

retrieve data from a database 

_ see if a text file is where you think it is 
create a new file 

read a character from the command-line 



What might go wrong 

the uy^tr is dowti 
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exceptions and flow controi 

Flow cohtrol iH try/catch blocks 

When you caJI a risky method, one of two things can hap- 
pen. The risky method either succeeds, and the try block 
completes, or die risky method throws an exception back to 
yotir calling method. 



If the try SUCCeeds 

(doRiskyThlngO does not 
throw an exception) 



try { 




) catch (Exception ex) { 

System- out. println ("'failed") ; 

} 



I File £dh WindCffi mo RiskAII I 



%java Tester 
We made it? 



If the try fails 

(because doRiakyThlngO 
doBS throw an exception) 



tr y { 

int b = f,getNum() 



— revest ^^f^.? 



} catch (Exception ex) { 

System . out * println ( " f aile<;; 



[ 



.0- 




FHo Edit Window Help ftt&yAll 



%java Tester 

failed 

We made it! 
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Finally: for the things you want 
to do ho maffer what 

If you try to cook something, you surt by turning on 
the oven. 

If the thing you try i5 a complete faflure, 
you have to turn off die oven. 

If the thing you try succeeds, 
you have to turn off the oven. 

You have to turn off the oven no matter what! 

A Anally block is where you put 
code that must run regardless 
of an exception. 

try { 

turnOvenOn () ; 

x.bake 0 ; 
] catch (BakingException ex) { 

ex . prints tackTrace () ; 
} finally { 

turnOvenOf f ( ) ; 

} 

Without finally, you have to put the 
tumOvenOffO in both the try and the catch 
because you have to turn off the oven no matter 
what. A finally block lets you put all your 
important cleanup code in oti^ place instead of 
duplicating it like this: 

try { 

turnOvenOn () ; 
x.bake () ; 
turnOvenOf f () ; 
} catch (BakingException ex) { 
ex.printStackTrace () ; 
turnOvenOf f () ; 

} 




If the try block falls (an exception), flow 
control immediately moves to the catch block. 
When the catch block completes, the finally 
block runs. When the finally block completes, 
the rest of the method continues on. 

If the try block succeeds (no exception), 

flow control skips over the catch block and 
moves to the finally block. When the finally 
block completes, the rest of the method 
continues on. 

If the try or catch block has a return 
atatementf finally will still runi Flow 
jumps to the finally, then back to the return. 
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■^^pen your pencil 



Flow Control 



Look at the code to the left. What do you think the 
output of this program would be? What do you think 
h would be ^f the third line of the program were 
changed to: String test - ^yes"; 7 
Assume Scary Exception extends Exception. 



public class TestExceptions { 

public static void main(String [] args) { 

String test = "no"; 
try { 

System. out. println( ''start try"); 
doRisky(test) ; 

System. out. println("ead try"); 
} catch ( ScaryException se) { 

System-out.println{ ''scary exception" ) ; 
} finally { 

System. out . println( "finally" ) ; 

} 

System. out. println( "end of main"); 

} 

static void doRi3ky( String test) throws ScaryException { 
Systejn.out»println( "start risky" ) ; 
if (''yes"-equals(te9t) ) { 

throw new ScaryException( ) ; 

} 

System, out , print In (''end risky" ) ; 
return; 



Output when teat = ^no" 



Output when test = "yes' 



uieuuppua - X||puy - Xjipu^ - Xj|Su pua - Xj|5!j ueu - AJjjjeis :^u,- isei ueqM 
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Pid we mention that a method can 
throw more than one exception? 

A method can throw multiple exceptions if it dam weU needs to. But 
a method's declaration must declare allxhe checked exceptions it can 
throw (although if two or more exceptions have a common superclass, the 
method can declare jnst the superclass.) 



Catehfag multiple exceptions 

The compiler will make sure that you've handled all the checked excep- 
tions thrown by the method you're calling. Stack the caUh blocks under 
the tjy, one after the other Sometimes the order in which you stack the 
catch blocks matters, but we'll get to that a little later. 



public class Laundry { 

public void doLaundryO throws PantsException , LingerieException 

// code that could throw either exception 

) 

J two t^'?^*^ 



public class Foo { 

public void goO { 

Laundry laundry = new Laundry {); 
try { 

laundry . doLaundry ( ) ; 
} catch (PantsExcepti on pex) 
// recovery code 

} catch (LingerieException lex) 

// recovery code 

} 



if 



i-f 6oL3unA*y() iht 
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Exceptions are polymorphic 

Exceptions are objects, rememben There's nothing all that 
special about one» except that it is a thing that can be tkroum. 
So like all good objects^ Exceptions can be referred to 
polymorphicaUy. A LingerieException otject, for example, 
could be assigned to a ClothingException reference. A 
PantsExcepdon could be assigned to an Exception reference. 
You get the idea. The benefit for excepdons is that a method 
doesn*t have to explicitly declare every possible exception it 
might throw; it can declare a superclass of the exceptions. 
Same thing with catch blocks — ^you don*t have to write a catch 
for each possible exception as long as the catch (or catches) 
you have can handle any exception thro^vn. 



You can DECLARE exceptions using 
a supertype of the exceptions you 
throw. 





public void doLaundry ( ) throws ClothingException { 
Wivid^lly. »?l;cH}y d^)aH^ 







3hlrt£xc*ptk» h 









^ You can CATCH exceptions using a 
supertype of the exception thrown. 



try { 

laundry , doLaundry ( ) ; 

) catch (ClothingException cex) { 

// recovery code 

} 




try ( 



laundry . doLaundry ( > ; 




) catch (ShirtExcaption sex) { 

// recovery code 

} 
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Just because you CAN catch everything 
with one big super polymorphic catch, 
doesnt always mean you SHOULD. 

You could write your exception-handling code so that 
you specify only one catch block, using the supertype 
Exception in the catch clause, so that you'll be able to 
catch any exception that might be thrown. 



try { 

laundry . doLaundry ( ) ; 
} catch (Exception ex) { 

// recovery code...^ 



Write a different catch block for each 
exception that you need to handle 
uniquely. 

For example, if your code deals with (or recovers 
from) a TeeShirtException differentiy than it handles a 
LingerieException, write a catch block for each. But if you 
treat all other types of ClothingException in the same way, 
then add a ClothingException catch to handle the rest. 

try { 

laundry . doLaundry ( } ; 



} catch (TeeShirtException tex) { 

// recovery from TeeShirtException 



} catch (LingerieException lex) { 



// recovery from LingerieException 
} catch (ClothingException cex) { 



I J-iinc 



// recovery from all others 



you are here ^ 331 



order of multiple catch blocks 



Multiple catch blocks must be ordered 
from smallest to biggest 




catch (TeaShirtRxception tex) 




aft 



catch (ShlrtException sex) 





catch (ClothingException c«x) 
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The higher up the inheritance tree, the bigger the 
catch 'basket*. As you move down the inheritance 
tree> toward more and more speciaHzed Exception 
classes, the catch 'basket' is smaller. It's just plain old 
polymorphism. 

A ShirtExcepdon catch is big enough to take 
a TeeShirtEjcception or a DressShirtExcepiion 
(and any future subclass of anything that extends 
ShirtExcepdon). A ClothingException is even bigger 
(i.e. there are more things that can be referenced 
using a ClothingException type). It can take an 
exception of type ClothingException (duh) , and 
any ClothingException subclasses: PantsExceprion, 
UnifonnException, LingerieException, and 
ShirtException. The mother of all catch arguments 
is type Exception; it will catch any exception^ 
including runtime (unchecked) exceptions, so you 
probably won't use it outside of testing. 

\ 



exception handling 



You can't put bigger baskets 
above smaller baskets. 

Well, you can but it won't compile. Catch 
blocks are not like overloaded methods 
where the best match is picked. With catch 
blocks, theJVM simply starts at the first one 
and works its way down imtiJ it finds a catch 
that's broad enough (in other words, high 
enough on the inheritance tree) to handJe 
the exception. If your first catch block is 
catch (Exception ax) , the compiler 
knows there's no point in adding any 
others — they'll never be reached. 




try ( 

laundry . doLaundry { ) 



) catch (ClothingException cex) { 

// recovery from ClothingException 




) catch (Lingari^Exeeption lex) { 

// recovery from LingerieExcepcion 





) catch (ShirtExcaption sex) ( 

II recovery from ShirtException 

) 



Sittings can lie in any trtler, liecause lliey 
cant catck One anotlier s exceptions 

You could put ShirtException above 
LingerieException and nobody would mind 
Because even though ShirtException is a bigger 
(broader) type because It can catch other classes 
(its own subclasses), ShirtException can't catch a 
LingerieException so there's no probiem. 

\. 
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polymorphic puzzle 




irpen your pencil 



Assume the try/catch block here is legally coded, Your task Is to draw 
Two different class diagrams that can accurately reflect the Exception 
classes, In other words, what class Inheritance structures would make the 
try/catch blocks In the sample code legal? 



try { 

x.doRisky {) ; 
} catch (AlphaEx a) { 

// recovery from AlphaEx 
) catch <BataEx b) { 

// recovery from BetaEx 
) catch (GammaEx c) { 

// recovery from GammaEx 
} catch (DeltaEx d) { 

// recovery from DeltaEx 

) 




Your task Is to create two different legal try / catch structures (similar to 
the one above left), to accurately represent the class diagram shown on 
the left Assume ALL of these exceptions might be thrown by the method 
with the try block, 
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Wheh you don't want to handle 
an exceptioh... 



just duck it 



If you don't want to handle an 
exception, you can duck it by 

declaring it. 

When you call a risky meLhod, the compiler 
needs you to acknowledge it. Most of the time, 
that means wrapping the risky call in a try/ 
catch. But you have anod^er ahemativej simply 
dtuk it and let the method tl-jat called you catch 
the exception. 

It's easy — all you have to do is d£clare thzt 
you throw the exceptions. Even though, 
technically, you aren't tlie one doing the 
ilirowing, it doesn't matter. YouVe stiJl the one 
letting the exception whiz right on by. 

But if you duck an exception, then you don't 
have a try/ catch, so what happens when the 
risky method (doLaundryO) does throw the 
exception? 

When a method dirows an exception, that 
method is popped off the stack immediately, 
and the exception is thrown to the next 
method down tlie stack- — the caller. But if the 
caller is a ducker, then there's no catch for it so 
the caller^o\>s off the stack immediately, and 
the exception is thrown to die next method 
and so on.,, where does it end? You'll see a 
litde laten 



pioblic void foo() throws Real lyBadExcept ion 
// call risky method without a try/catch 
laundry . doLaundry ( ) ; 

} 
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Puckihg (by declaring) only 
delays the inevitable 

Sooner or later, somebody has to 
deal with it. But what if maln() 
ducks the exception? 

public class Washer { 

Laundry laundry = new Laundry (); 

public void fooO throws ClothingExcoption i 

laundry. doLaundryO ; 

) 

public static void main (Stringt] args) throws ClothingExcaption ( 
Washer a - new Washer(); 
a. foo () ; 

} 

) 



/ 



doLaundryO throws o 
ClotKingExccption 




main{) calls fooQ 

fooQ calls doLaundr/O 

doLaundryO is 
running and throws a 
ClothingExccptron 



f ooO ducks the 
exception 




doLaundryO pops off the 
stack immediately ond 
the exception is thrown 
back to f oo(). 

But f ooO doesn't have a 
try/catch, so... 



marnO ducks the 
exception 




foo() pops off the 
stack immediately and 
the exception is thrown 
back to... who? Whot? 
There's nobody left 
but the JVM, and it's 
thinking, *bon't expect 
ME to get you out of 
this." 



o 



The JVM 
shuts down 



We're using Ihe tee-shirt to represent a Clothing 
Exception. We know, we know... you would 
have preferred ttie blue jeans. 
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Handle or Declare. It's the law. 

So now we've seen both ways to satisfy the compiler 
when you call a rishy (exception-throwing) method. 

# HANDLE 

Wrap the risky call rn a try/catch 

try { ^ 

laundry . doLaundry ( ) ; 
} catch (ClothingException cex) 

// recovery code 

} 



DECLARE (duck it) 

Declare that YOUR method throws the same exceptions 
as the risky method you're calling. 

void fooO throws ClothingException { 

laundry . doLaundry ( ) ; ^'^•^ — 

} 



But now this means that whoever calls the foo() method 
has to follow the Handle or Declare law. If f ooQ ducks 
the exception (by declaring it), and main() calls f ooQ, then 
mainO has to deal with the exception. 



public class Washer 
Laundry laundry 



{ 



new Laundry ( ) ; 



public void foo() throws ClothingException { 



laundry .doLaundry 0 ; 



} 



public static void main (String [] args) { 
Washer a = new Washer 0 ; 
a.fooO; ^--..^ 

Cl^ptucfho. ttvpw. by doU^^) 



trouBlb!! 
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fixing the Sequencer code 



letting back to our music code... 

Now that youVe completely forgotten, we started this chapter 
with a first look at some JavaSound code. We created a Se- 
quencer object but it wouldn't compile because the method 
Midi.getSequencerO declares a checked exception (MidiUnavail- 
ableException). But we can fix that now by wrapping the call in a 
try/ catch. 



public void playO { 

try { 




Sequencer sequencer = MidiSystem. getSequencer ( ) ; 
System, out. println (^^Successfully got a sequencer"); 



} catch (MidiUnavailableException ex) 

System. out. println (^^Bummer") ; 

} 

} // close play 



Exception Huks 



You cannot have a catch or finally 
without a try 

HOT ue^^^' 



void go 0 { 

Foo f = new Foo { ) ; 
f .foof 0 ; 

catch {FooException ex) 



{ } 



A try MUST be followed by either a 
catch or a finally LE^^f^ 



try { 

x.doStuff 0 ; 
} finally { 

// cleanup 

} 



You cannot put code between the 
try and the catch 



try { 

X.doStuff 0 

} 

int y = 43; 
} catch (Exception ex) 



^ A try with only a finally (no catch) 
must still declare the exception. 



{ } 



void go() throws FooException { 
try { 

X.doStuff 0 ; 
} finally { } 

} 
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Code Kitcken 



6ut why don't 
you just use 
fteody-bake code? 




Yoti ioni kave to do it 
yourseU, tut rt*s a lot 
more fun if you cto. 

Tlie rest oi tliis ckapter 
is optiimal; you can use 
1lead[^-kake code for all 
tke music apps. 

But if you want to learn 
more al>aut JavaSound> 
turn tte 



> 
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JavaSound MIDI classes 

Making actual sound 

Remember near the beginning of the chapter, we Jooked at how MIDI data holds 
the instructions for what should be played (and how it should be played) and we 
also said that MIDI data doesn't actually create any sound that you hear. For sound 
to come out of the speakers, the MIDI data has to be sent through some kind of 
MIDI device that takes the MIDI instructions and renders them in sound, either 
by triggering a hardware instrument or a 'virtual' instrument (software synthe- 
sizer). In this book, we're using only software devices, so here's how it works in 
JavaSound: 

You need FOUR things: 



The thing that 
piays the music 



Sequencer 



plays 




The Sequencer Is the thing 
that actually causes a song 
to be played.ThInk of It like 
a musk CD player. 



The mustc to be 
played... a song. 



> Sequence 




The Sequence is the 
song, the nr^uslcal piece 
that the Sequencer will 
play. For this book> think 
of the Sequence as a 
music CD, but the whale 
CD plays just one song. 



The port of the 
Se<)uence that 
holds the octuol 
information 



The actual music 
Information; 
notes to ploy, 
how long, etc. 



has a 



Track 



holds 



For this book, we only 
need one Track, so just 
Inr^aglnea a music CD 
with only one song. A 
single Track. This Track 
Is where all the song 
data {MIDI infornrtation) 
lives. 



CP " J. 
v««*^^ ... 





A MIDI event is a message 
that the Sequencer can 
understand. A MIDI event 
might say (if it spoke 
Engllsh)/At this moment 
In time, play middle C, play 
it this fast and this hard, 
and hold It for this long." 

A MIOf event might 
also say something like, 
"Change the current 
instrument to Flute/ 
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And you need FIVE steps; 

^ &et a Sequencer and open it 

Sequencer player = KidiSystejn.getSequencer () ; 
player .open () ; 

@ Make a new Sequence ./^ 

Sequence seq - new Sequence (timing, 4) ; 

Set Q new Trock from the Sequence 

Track t = seq. createTrack () ; 



^ Fill the Track with MidiEvents and 
give the Sequence to the Sequencer 
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a sound application 

Your very first sound player app 

Type it in and run it. You'll hear the sound of someone playing a 
single note on a piano! (OK, maybe not someone, but something.) 



import javax. sound. midi. *; ^ — 
public class MiniMiniMusicApp { 



the midi pad^^ 



public static void main (String [ ] args) { 

MiniMiniMusicApp mini = new MiniMiniMusicApp () , 
mini .play ( ) ; 

} // close main 

public void playO { 
try { 



Sequencer player = MidiSystem . getSequencer () 
player .open () ; 



Sequence seq new Sequence (Sequence . PPQ, 4); 



Track track = seq. createTrack () 



^ShortMessage a = new ShortMessage ( ) ; 
a.setMessage(144, 1, 44, 100); 
MidiEvent noteOn = new MidiEvent(a, 1) 
track. add (noteOn) ; 



\ ShortMessage b - new ShortMessage () ; 

/ b.setMessage (128, 1, 44, 100) ; 

/ MidiEvent noteOff = new MidiEvent (b, 16), 

V track. add (noteOff) ; 



Put /HidiEv«,t, into tKe T»-atk. TKis 
« -<«tly f?«dy-bak. dode. TKe only thinj you'll 
have to about a.^e the a>^un.ent* to tk 
*etMe«a3eO ^etKod, irA the a^-jun^ents to 
iKe /WidiEvent tonstruttov. IVe'lI look at those 
airjuments ox the next f a5e 



player . setSequence (seq) ; ^ ^j^^ ^ ^^^^^^ ^ ^j^^ ^^^^^^ (^^^ 

player . start ( ) ; ^ futtinj the CP in tKe CD flayev) 

^^HO tK* C 



} catch (Exception ex) { 

ex.printStackTrace () ; 

} 



} 

} // 



// close play 
close class 
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Makihg a MidlEveht (song data) 

A MidiEvent is an instruction for part of a song. A series of MidiEvenCs is 
kind of like sheet miisic, or a player piano roll. Most of the MidiEvents we 
care about describe a thing to do and the moment m time to do it The moment 
in time pan matters, since timing is everything in music. This note follows 
this note and so on. And because MidiEvents are so detailed, you have to say 
at what moment to 5^r^ playing the note (a NOTE ON event) and at what 
moment to stop playing the notes (NOTE OFF event). So you can imagine 
that firing the "stop playing note (NOTE OFF message) before the "start 
playing Note G" (NOTE ON) message wouldn't work. 

The MIDI instruction actually goes into a Message object; the MidiEvent is 
a combination of the Message plus the moment in time when that message 
should 'fire'. In other words, the Message might say, ''Start playing Middle 
while the MidiEvent would say, ""Trigger this message at beat 4"". 

So we always need a Message and a MidiEvent. 

The Message says what to do, and the MidiEvent says when to do it. 



Moke a Message 

ShortMessage a = new ShorrMessage () ; 



l ijplwt tocfoand 
Mtei to do^ ^ 

I lltStlHIiCtlOIL 

lep WQPcEs, at 
beat 




Put the Instruction in the Message 

a.setMessage(144, 1, AA, 100) ; 

Make q new MidiEvent using the Message 

MidiEvent noteOn = new MidiEvent (a, 1) 

Add the MidiEvent to the Track 

track . add <noteOn) ; j 



t^'jga^ed. this Mid\Bve^4- *iv^ x i . 



I Oh 



you are here ^ 343 



contents of a Midi event 



M\V\ message: the heart of a MidfEveht 

A MIDI message holds the part of the event that says what to do. The actual instruction 
you want the sequencer to execute. The first argument of an instruction is always the type 
of the message.The values you pass to the other three arguments depend on the type of 
message. For examplci a message of type 144 means "NOTE 01^". But in order to carry 
out a NOTE ON> the sequencer needs to know a few things.-Itnagine the sequencer saying, 
"OK, rU play a note, but which channel In other words, dc/yoM want me to play a Drum 
note or a Piano note? And which note^ MiddJe-C? D Sharf)^ And while we're at it, at which 
vebcity should I play the note? \ 

To make a MIDI message, make aShortMessage instance and invoke setMessage(), passing 
in the four arguments for the message. But remember, the message says only what to do, so 
you still need to stuff the message into an event that adds when that message should 'fire'. 

Anatomy of a message 

The first argument to setMessageO always 
represents the message *type', while the other 
three arguments represent different things 
depending on the message type. 



The Mess€ige says \iiiat to do, the 
MidiEvent says when to do it 



a . setMessage 




Message type 




Channel 

Think of a channel like a musician in 
a bond, Channel 1 is musician 1 (the 
keyboard player), channel 9 f5 the 
drummer, etc. 



h4ote to ploy 

A number from 0 to 127, going 
from low to high notes. 



128 means 
NOTE OFF 




I Velocity 

How fast and hard ^ — did 
you press the key? 0 is so soft you 
probably won't hear anything, but 100 is a 
good default. 
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Now that you know what's in a Midi message, you can start experimenting. You 
can change the note that's played, how long the note is held, add more notes, 
and even change the instrument. 



^ Change the note 

Try a number between 0 and 127 in the note 
on and note off messages. 

a.setMessage(144, 1, 20, 100); 




^ Change the duration of the note 

Change the note off event (not the message) so 
that it happens at an earlier or later beat, 

b.setMessage(128, 1, 44, 100); 
MidiEvent noteOff = new MidiEvent (b, 3 



3)' ^ 



Change the instrument 

Add a new message, BEFORE the note-ploying message, 
that sets the Instrument in channel 1 to something other 
thon the default piono. The change-Instrument messoge 
is '192\ and the third argument represents the actual 
instrument (try a number between 0 and 127) 

first. setMessage(192, 1, 102, 0); 




change the instrument and note 



yersioh 2: Using comniahd-lihe args to experiment with sounds 

This version still plays just a single note, but you get to use command-line argu- 
ments to change the instrument and note. Experiment by passing in two int values 
from 0 to 127. The first int sets the instrument, the second int sets the note to play 

import javax. sound -midi. ^ 

public class MiniMusicCmdLine { // thisXs^the first one 

public static void main (String f 1 args!) { 

MiniMusicCmdLine mini = new MiniMusicCmdLine () ; 
if (args. length < 2) { 

System. out .println ("'Don' t forget the instrument and note args"); 
) else { 

int instrument = Integer , parseint (args [ 0 1 ) ; 
int note = Integer .parseint (args [1) 1 ; 
mini .play (instrument / note) ; 

) 

} // close main 



public void play (int instrument, int note) { 



try { 



Sequencer player = MidiSystem.getSequencer () ; 
player .open () ; 

Sequence seq = new Sequence (Sequence - PPQ, 4) ; 
Track track = seq. createTrack () ; 



MidiEvent event = null; 



ShortMessage first = new ShortMessage ( ) ; 

first . setMessage (152, 1, instrument, 0) ; 

MidiEvent changelnstrixment = new MidiEvent (firsty 1); 

track. add (change Instrument) ; 



ShortMessage a = new ShortMessage 0 ; 
a. setMessage (144, l, note, 100) ; 
MidiEvent noteOn = new MidiEvent (a, 1) ; 
track . add (noteOn } ; 



Ru^ rt wi-ti^ "two i^i 3ir^ -frow 0 
io 111. Try fcfr rbrUrv' 

I File Edit Wfndow Help Allfinuale | 



ShortMessage b = new ShortMessage () ; 
b. setMessage (128, 1, note^ 100) ; 
MidiEvent noteOff = new MidiEvent (b, 16); 
track. add (noteOf f ) ; 
player . setSequence (seq) ; 
player. start () ; 

) catch (Exception ex) { ex . printStackTrace () ; ) 
( /./ cloee play 
) // close class 



%java MiniMusicCmdLine 102 30 
%java MiniMusicCmdLine 80 20 
%java MiniMusicCmdLine 40 70 
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Where weVe headed with the rest 
of the CodeKitchens 



Chapter 15: the goal 

When were done, we'ff have a working 
fteotSox thaVs also a Drum Chat Client. 
We'll need to learn about GUIs (includ- 
ing event handling), I/O, networking, ond 
threads. The next three chapters (12, 13, 
ond 14) will get us there. 



owflm-rtii □BeBBQedQOOOqCDO 
AcQu»tk AsjwO QQ0Q0OQ^ □ S SDG OB 

*mrj><>r □□□□QDaopaQoaou- ^ 
^» doflosofiDttGoSGfloiio ; 



Chapter 12: MIDI events 

This CodeKitchen lets as build a little 
*music video" (bit of a stretch to call it 
that,..) that draws random rectangles to 
the beat of the AAIOI music. We'll learn 
how to construct and ploy a lot of Mlbl 
events (instead of just a couple, as we do 
in the current chapter). 




beat on€ 



Chapter 13: Standalone 
BeatBox 

Now we'll actually build the real BeatBox, 
6UI and all. But it's Jimited—os Soon as you 
change a pattern, the previous one is lost. 
There's no Save and Restore feature, and 
it doesn't communicote with the network. 
(But you can still use it to work on your 
I'drum pattern skills.) 



om»* HJ-k-c z- :j z _ 1 _ . _ _ . _ a Z f 

HMdQw aGQQQQOODHBOSBOO - 
ni9hT»« 8GQ0QBQODODGGBOQ 

ooQsaQQGOoooQoee 
io-c«iM oaaQDsaQOpaoaDoej 

uwfUv _■ J J J J U Qtf GSOQG 



Chapter 14: Save and 
Restore 

tVouVe made the perfect pattern, ond 
ii*ow you con save it to a file, and reload it 
'when you want to play it again. This gets 
I us ready for the fnal version (chapter 15), 
where instead of writing the pattern to a 
L file, we send it over o network to the chat 
|:$crver. 



tfGOBQQOOPQBGQDOOti^Si^ 

OBQBeeQBoeeeeQdEF- ' 

M^Kii OBaGSapCOGODQBaQ 

tf^Hik Beas^eaooGGOBBQ 
t^c*^ oeoBQcseooooDsoeB 

itaaoaBQQQoeaejOBD: 
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This chapter explored the wonderful world of 
exceptions. Your job is to decide whether each of the 
following exception-related statements is true or faise. 

1. A try block must be followed by a catch Ind a finally block. 

2. If you write a method that might cause a compiler-checked exception, you 
must wrap that risky code in a try / catch block. 

3. Catch blocks can be polymorphic, 

4. Only ^compiler checked' exceptions can be caught 

5. If you define a try / catch block, a matching finally block is optional, 

6. If you define a try block, you can pair it with a matching catch or finally block, 
or both, 

7. If you write a method that declares that it can throw a compiler-checked ex- 
ception, you must also wrap the exception throwing code in a try / catch block. 

8. The main( ) method in your program must handle all unhandled exceptions 
thrown to it, 

9. A single try block can have many different catch blocks. 

10. A method can only throw one kind of exception. 

11. A finally block will run regardless of whether an exception is thrown. 

12. A finally block can exist without a try block. 

13. A try block can exist by itself, without a catch block or a finally block. 

14. HandJing an exception is sometimes referred to as 'ducking'. 

15. Tlie order of catch blocks never matters. 

16. A method with a try block and a finally block, can optionally declare the 
exception, 

17. Runtime exceptions must be handled or declared. 
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Code Magnets 



A working Java program is scrambled up on the fridge. Can you 
reconstruct all the code snippets to make a working Java program 
that produces the output listed below? Some of the curly braces fell 
on the floor and they were too small to pick up, so feel free to add as 
many of those as you needl 



system * out . print ( "r 




class MyEx extends Exception { } 



public class ExTestDrive ( 




static void doRisky( String t) throws MyEx ( 
Sy3tein*out, print ( "h" ) ; 



static void main(String t ] «gs) i 
String test ■ argstOl? 
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^ java ExTestDrive yes 
thaws 

? java ExTestDtive no 
throws 



puzzle: crossword 




Yo u know what to do ( 



Across 

1. To give value 
4. Flew off the top 
6. All this and more! 
8. Start 

10, Ttie family tree 
13. Noducking 
15. Problem objects 
18. One of Java's '49" 



20. Class hierarchy 

21. Too hot to har^dle 

24. Common primitive 

25. Code recipe 

27. Unruly method action 

28. No Picasso here 

29. Start a chain of events 



Down 

Z Currently usable 

3. Template's creation 

4. Dont show the kids 

5. Mostly static API class 

7. Not about behavior 

9. Tt^e template 

1 1 . Roll another one off 
the \ine 



12. Javac saw it coming 
14. Attempt risk 

16, Automatic acqulsftion 

17. Changing method 
19. Announce a duck 

22. Deal with rt 

23. Create bad news 
26. One of my roles 



More Hints: 



qscMiiinouj p JO Z 

UMOO 
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Excise Solutions 



1 

1 . False, either or both. 

2. False, you can declare the exception. 

3. True. 

4. False, rundme exception can be caught. 

5. True. 

6. True, both are acceptable. 

7. FaJse> the declaration is sufficient. 

8. False, but if it doesn*t the JVM may shut 
down. 

9. True. 

10. False. 

11. Thie. It*s often used to clean-up partially 
completed tasks, 

12. False. 

13. False, 

14. False, ducking is synonomous with declar- 
ing. 

15. False, broadest exceptions must be caught 
by the last catch blocks. 

16. False, if you don*t have a catch block, you 
muji declare. 

17. False. 



Code Magnets 

class MyEx extends Exception { } 

public class ExTestDrive { 

public static void main (String [5 euogs) { 
String test = arg3[0j; 
try { 

System. out .print C't") ; 
doRiskyi test) ; 
System, out. pr int { "o" ) ; 
} catch ( MyEx e) { 

System. out. print ("a" ) ; 
> finally { 

System, out- print ( *'w" ) ; 

> 

Sy8tem.out-println(*s'') ; 

} 

static void doRisky (String t) throws MyEx { 
System-out. print ("h" ) ; 

if (^'ye8''.Gquals(t) ) { 

throw new MyEx(); 

> 

System, out. print ( "r") j 

y 

} rut m wndwHtifp cha 




java ExTestDrive yes 
thaws 

% java ExTestDrive no 
throws 
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Jav^r^ss Answers 
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12 getting gui 



A Very Graphic 




Face it, you need to make GUIs, if you're building applications that other 
people are going to use, you n^ed a graphical interface. If you're building progranns for yourself, 
you want a graphical interface. Even if you believe that the rest of your natural life v^ill be 
spent writing server-side code, where the client user Interface Is a web page, sooner or later 
youll need to write tools, and you'll want a graphical interface. Sure, command-line apps are 
retro, but not in a good way.TheyVe weak, inflexible, and unfriendly. Well spend two chapters 
working on GUIs, and learn key Java language features along the way including Event 
Handling and Inner Classes. In this chapter, we'll put a button on the screen, and make It do 
something when you click it. We'll paint on the screen^ we'll display a jpeg image, and we'll even 
do some animation. 
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your first gui 



it all starts with a window 

AJFrame is ihe object that represents 
a isindow on the screen. It's where you 
put all the interface things like buttons, 
checkboxes, text fields, and so on. It can 
have an honest-to-goodness menu bar 
\vith menu items. And it has aU the httle 
windowing icons for whatever platform 
you're on, for minimizing, maximizing, and 
closing the window. 

The JFrame looks different depending on 
the platform you're on. This is a JFrame on 
Mac OS X: 




^If I see one more 
command-Mne app, 
you're fired." 



File Panic 



Deviate 



Put widgets in the window 

Once you have a JFrame, you can put 
things (^widgets') in it by adding them 
to tlieJFrame. There are a ton of Swing 
components you can add; look for them 
in thejavax.swing package. The most 
common include JButton.JRadioButton, 
JCheckBox.JLabel^JUstJScrollPane, 
JSlider, JTextArea, JTexiField, and 
JTable. Most are really simple to use, bxit 
some (like JTable) can be a bit more 
complicated. 



Making a GUI is easy: 

^ Make a frame (o JFramc) 

JFrame frame ^ new JFrame () ; 



@ Make a widget (btrrron, text field, etc.) 

JButton button = new JBu t ton click ma") 

@ Add the widget to the frame 

frame^getContentPano 0 .add (button) ; 



bisploy it (give it a ^ize and moke rt visible) 

frame, setSiza (300, 300) ; 
f rama . aotViaUble (tirue) ; 
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Your first ^Ul; a button on a frame 

iJBport javax. swing.*; <^ svjin^ f^dka^t 



piiblic class SimpleGuil { 



public static \roid main (StringH arga) { ^ ^1*^3'^^^^^'^'^^^^ 



JFcame frame = new JFrame () ; ^ 
JButton button = new JBut ton (''click 



frame . setDef aultCloseOperation < JFrama .EXIT_ON_CLOSE) ; 

frame. getContentPanaO .add (button) ; J**^ ^'"^ oh stYttr^ (orc^c^ 



frame . aet^ize (300 , 300) ; 
fraiae.flatViaible(trufi) ; 



Let's see what happens when we run It: 

%java SimpleGuil 




Whoa! Thaf s a 
Really Big Button. 

The button fills oil the 
avQfJable spoce in the frame. 
Later we'll learn to control 
where (ond how big) the 
button is on the frame. 
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l^ut hothihg happens when I click it... 

That s not exactly true. When you press the button it shows thai 
'pressed' or 'pushed in* look (which changes depending on the 
^iMform look and feel^ but it al^vays does something to show when 
it*s h^ng-pfessed). 

The real question is, ""How do I get the button to do something 
specific when the user clicks it?" 

We need two things: 

® A tncfhod to be called when the user 
clicks (the thing you want to happen as 
a result of the batten click). 

@ A way to know when to trigger 
that method. In other words, a way 
to know when the user clicks the 
buttoni 




When the user clicks, we want 
to know. 

We're interested in the user- 
takes-action-on-a-button event. 



will a button look like a 
Windows button when you run on 
Windows? 

If you want it to. You can 
choose from a few^'look and 
feels"— classes in tl^e core library 
tt^at control wliat the interface looks 
like. In most cases you can choose 
between at least two different looks: 
the standard Java look and feel, also 
known as Metai, and the native look 
and feel for your platform. The Mac 
OS X screens in this book use either 
the OS X Aqua look and feel, or the 
Mefa/ look and feeL 

Can I make a program look 
like Aqua all the time? Even when 
It's running under Windows? 

Nope. Not all look and feels 
are available on every platform. If 
you want to be safe, you can either 
explicitly set the look and feel to 
Metal, so that you know exactly what 
you get regardless of where the app 
is running, or don't specify a look 
and feel and accept the defaults. 

I heard Swing was dog-slow 
and that nobody uses It. 

This was true rn the past 
but Isn't a given anymore. On weak 
machines, you might feel the pain of 
Swing. But on the newer desktops, 
and with Java version 1 .3 and be- 
yond, you might not even notice the 
difference between a Swing GUI and 
a native GUI. Swing Is used heavily 
today, in all sorts of applications. 
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^ettiifig a user event 

Imagine you want the text on the button to 
change from click me to Fve been clicked when 
the user presses the button. First we can write a 
method that change^^the text of the button (a 
quick looklhrougfi the API will show you the 
inethod): 



Ijjiublic void chang^ItO ( 

I button. s«tText('' I 'va bean clicked!"); 

But nmt'what? How will we Ati^ when this 
[Method should run? Haw wiQ we knofw when the 
^^Imtionis clicked f 

In Java, the process of getting and handhng a 
yutser event is called event-handling. There are 
ptnany different event types in Java, although 
i most involve GUI user actions. If the user clicks 
||L button, that's an event An event that says 
■*The user wants the action of this button lo 
Riappen." If it's a "Slow Tempo" button, the user 
nants the slow-tempo acdon to occur. If it's a 
feend button on a chat client, the user wants the 
pend-my-me&sage action to happen. So the most 
gtraightforward event is when the user clicked 
Wt^ button, indicating they want an action to 

fWith buttons, you usually don't care about any 
feotermediate events Hke button-is-being-pressed 
niKi button-is-being-releascd. What you want to 
Kay to the button is, "I don't care how the user 
»lays with the button, how long they hold the 
Riiduse over it, how many limes they change their 

mind and roU off before letting go, etc Just tell 
kpe when the user means business! In other words, 
Bon't call me unless the user clicks in a way that 
pndicates he wants the dam button to do what it 
Ipysitll dol" 



First, the button needs to know 
that we care. 



tfcy kutbcm> I urt about 




Second, the button needs a way 
to call us back when a button- 
clicked event occurs. 



1) How could you tell a button object that you 
care about its events? That youVe a concerned 
listener? 



2) How will the button caii you back? Assume 
that there's no way for you to teil the button the 
name of your unique method (changeltO). So 
what eise can we use to reassure the button that 
we have a specific n^ethod it can call when the 
event happens? [hint: thir^k Pet] 
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event listeners 



If you care about the button's events, 



implement an interface 


that says, 


"I'm 


listening 


^or your events." 



A listener interface is the bridge between the 
listener (you) and event source (the button). 

/' 

The Swing GUI components are event sources. In Java terras, 
an event source is au object that can turn user actions {dick 
a mouse, type a key, close a window) into events. And like 
viraially everything else in Jav^a, an event is represented as an 
objecL An object of some event class. If you scan through the 
java.a\w:. event package in the API, you'll see a bunch of event 
classes (easy to spot — they all have Event in the name). You'l) 
find MouseEvent^ KeyEvent, MIndowEvent, AcdonEvent, and 
several others. 

An event source (like a button) creates an eveni object when the 
user does something that matters (like dkk ihe: button). Most 
of the code you write (and all the code in this book) will receive 
events rather than creat£ events. In other words, you'll spend 
most of your rime as an event listener r^x}\eT than an event source. 

Every event type has a matching listener interface. If you want 
MouseEvents, implement the MouscListener interface. Want 
WindowEvenis? Implement WindowLisiener You get the idea. 
And remember your interface rules — to implement an interface 
you declare thai you inr^p^ement it (class Dog implements Pet), 
which means you must lurite implementation methods for every 
mednod in the interface. 

Some interfaces have more than one method because the 
event itself comes in different flavors. If you implement 
MouseListener, for example, you can get events for 
mousePressed^ mouseReleased, mouseMoved, etc. Each of 
those mouse events has a separate method in the interface, 
even though tliey all take a MouseEvent. If you implement 
MouscListener, the moiisePressed() method is called when the 
user (you guessed it) presses die mouse. And when the user lets 
go, the mouseReleasedO method is called. So for mouse events, 
there's only one event object, MouseEvent, but several different 
event metlwds, representing ihe different of mouse events. 



you jit^leiqent a 
listener interface, you ^e 

button a way to call 
you baclt- TTie interface is 
\^4iere ^ call-baclt mediod 
is cJeclared. 
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How the listener and source 
communicate: 



getting gui 



Sutton, piaxse odd me to 

f listeners and col) 
QCtionPerf ormed() method 
user clicks you." 



your 1 
my 
when 







Tke Listener 



[f your class wants to know about 
a button's Ac1(onEvents,you 
implement the ActionLlstener 
interface, The button needs to 
know you're Interested, so you 
register with the button by calling Its 
addActionUstener(this) and passing an 
ActionLlstener reference to it (in this case, 
you are the ActionLlstener so you pass 
this) Jhe button needs a way to call you 
back when the event happens, so it calls 
the method in the listener interface. As an 
ActionLlstener, you must implement the 
interface's sole method, aaionPerformedQ, 
The compiler guarantees it. 



Tke Event 

A button is a source of Action Events, 
so it has to know which objects are 
interested ilsteners/fhe button has an 
addActionListenerO method to give 
Interested objects (listeners) a way to 
teltxhe button the/re interested. 

When the button's 
addActionListenerO runs (because 
a potential listener invoked it), the 
button takes the parameter (a 
reference to the listener object) and 
stores it in a listWhen the user clicks 
the button, the button 'fires'the event 
by calling the actionPerformedO 
method on each listener in the list. 
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Getting a button's ActionEvent 

@ Implement the iActionListener interface 




® Register with the button (tell it you 
want to listen for events) 



0 Define the event-handling method (implement 
the actionPerformedO method from the 
ActionListener inferrface) 



import javax. swing. * ; \m?ov4^ state^^"^ . 

import java.awt.event.*; ^ ^^t^o^^UsW air.d htb<>^^^^^^ sa^s, 

public class SimpleGuilB implements ActionListener { * ,^^3^^tt ^ 
JButton button; v^U*^***^" ' 

public static void main (String [] args) { W^'t"^ er^^ 

Siit^leGuilB gui new SimpleGuilB () ; (^^^^ . Wt^or ^^''f 

gui.goO; iHtt^o^^"^ 

} 

public void go() { 

JFrame frame « new JFrame(> ; . , 'X^^^ 

button = new OButton ("click me"); , t-tV* ■y**' ^^^^C Vstc**'**^* 



button. addActionListener (this) ; -^-"^ '^^^'^ !" 

frame.getContentPaneO .add (button) ; 

frame. setDefaultClose<^eration( JFrame. EXIT_ON_CLOSE) ; , t JPatC*^ 

frame. setSi2e(300. 300) ; A^-bonU^^^^*^ ^ 

frame , setVisible (true) ; Uv\e"^^^^ /^ i^Vvod '^^^ *^ 

p\ibllc void actionPerformed (ActionEvent event) { 
button.setTextC'I've been clicked!"); 

} 



} 
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For most of your steUar Java career, y(ni will not be the source 
of events. 




(No maaer how much you fancy yourself the center of your sodzJ 
univene.) 



Get used to it. Yourjifbisto be a good listener. 

(Which, if you do it sincerely, can improve your social life.) 



As a listener, my job is to 
implement the interface, 
register with the button, and 
provide the event-handling. 




Listener GETS the 
event 



As an event source, my job is to 
accept registrations (from listeners), 
get events from the user, and 
coll the listener's event-handling 
method (when the user clicks me) 



Source SENDS 
the event 




Hey, what about me? Tm a player too, you 
knowl As an event object, I'm the argument 

to the event call-back method (from the 
interface) end my job \$ to cony data aboirf 
the event back to the listener. 



Event object 
HOLDS DATA 
about the event 
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A: 



Why can't I be a source of events? 



L- You CAN. We Just said that mosf of the time 
you'll be the receiver and not the originator of the 
eVnt (at least in the e^iWy days of your brilliant Java 
care^r>^Mo$t^the events you might care about 
are 'fired' by classes in the Java API,and all you have 
to do Is be a listener for them. You might, however, 
design a program where you need a custom event, say, 
StockMarketEvent thrown when your slock market 
watcher app finds something it deems Important, In 
that case, you'd make the StockWatcher object be an 
event source, and you'd do the same things a button 
(or any other source) does — malce a listener interface 
for your custom event, provide a registration method 
(addStockListenerO), and when somebody calls it, add 
the caller (a listener) to the list of llsteners.Then, when 
a stock event happens, instantiate a StockEvent object 
(another class you'll write) and send It to the listeners 
in your list by calling their stockChanged(StockEvent 
ev) method. And don't forget that for every event type 
there must be a matchfng listener Interface (so you'll 
create a StockListener interface with a stockChangedO 
method). 



J don't see the Importance of the event object 
thafs passed to the event call-back methods. If 
somebody calls my mousePressed method, what 
other Info would I need? 



A: 



rpen your pencil 



A lot of the time, for most designs, you don't 
need the event object. It's nothing more than a little 
data carrier, to send along more info about the event. 
But sometimes you might need to query the event for 
specific details about the event- For example, if your 
mousePressedO method is called, you know the mouse 
was pressed. But what if you want to know exactly 
where the mouse was pressed? In other words, what if 
you want to know the X and Y screen coordinates for 
where the mouse was pressed? 

Or sometimes you might want to register the same 
listener with /nu/f/p/e objects. An onscreen calculator, 
for example, has 10 numeric keys and since they all do 
the same thing, you might not want to make a separate 
listener for every single key Instead, you might 
register a single listener with each of the 10 keys, and 
when you get an event {because your event call-back 
method is called) you can caK a method on the event 
object to find out w^o the real event source was. In 
other words, which key sent this event. 



Each of these widgets (user Interface objects) are the 
source of one or more events. Match the widgets with 
the events they might cause. Some widgets might be a 
source of more than one event, and some events can be 
generated by more than one widget. 



Widgets 



Event methods 



check box 


windowClosingO 


text field 


action PerformedO 


scrolling list 


ItemStateChangedO 


button 


mousePressedO 


dialog box 


keylypedO 


radio button 


mouseExitedO 


menu Item 


focusGainedO 



anoBjeetisanewnt 
SOUR*? 

Lo^ In th* API. 

lod that start* wWi 
with 'UStMMf*, 

a IManer bitafw 
Iff 




fliat « elaMt 

method Is 
KayEyaal 
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letting back to graphics... 

Now that we know a little about how events work {we'll learn 
more later), let's get back to putting stufiF on the screen. 
We'll spend a few minutes playing with some fun ways to get 
graphic, before returning to event handling. 

Three ways to put things on your GUI: 

Puf^vidgets on o frame 

Add buttons, menus, radio buttons, etc. 
frame.gQtContantPane () . add (myButton) ; 

The javox-swing package has more than a dozen 
widget types. 




brow 2 b graphics on a widget 

Use 0 graphics object to point shapes, 
graphics .fillCn^l (70,70,100,100) ; 

You can paint a lot more than boxes and circles; 
the jQvaZD API is full of fun, sophisticated 
graphics methods. 




Number of Head 
Flfsi Java books 
mistakenly 
bought by coffee 
house barlslBS. 




Put Q JPE6 on a wfdget 

You can put your own images on a widget, 
graphics . drawXmage {myPic, 10 , LO , this) 
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Make your owh drawing widget 

If you want to put your own graphics on the screen, your best 
bet is to malce your own pain table widget. You plop that widget 
on the frame Just like a button or any other widget, but when it 
shows up it will have your images on it. You can even make those 
images move, in an animation, or make the colors on the screen 
change every time you click a button. 

"it^s^a-piece of cake. 

Make a subclass of JPanel and override one 
method, paintComponent(). 

All of your graphics code goes inside the paintComponent() 
method. Think of the paintComponent() method as the method 
called by the system to say^ ""Hey widget, time to paint yourself.** 
If you want to draw a circle, the paintComponent() method will 
have code for drawing a circle. When the frame holding your 
drawing panel is displayed, paintComponent() is called and your 
circle appears. If the user iconifies/minimizes the window, the 
JVM knows the frame needs "repair" when it gets de-iconified, 
so it calJs paintComponentO again. Anytime the JVM thinks the 
display needs refreshing, your paintComponent() method will be 
called. 

One more thing, you never call this method yaurse^ The argument 
to this method (a Graphics object) is the actual drawing canvas 
that gets slapped onto the mx/ display You can't get this by 
yourself; it must be handed to you by the system. You'll see 
later, however, that you can ask the system to refresh the display 
(repaintO), which ultimately leads to paintComponent() being 



called. 



import java.awt.*; 
insert javax, swing.*; 



class MyDrawPanel extends JPanel { 





public void paintConiponent (Graphica g) { 



g.setColor(Color. orange) ; 



g.fillRect(20,50,100,100) ; 



telling 
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Fun things to do In paintCompoHCHtO 

Let*s look at a few more things you can do in paintCoraponent(). 
The most fun, tlioughi is when you stan experimenting yourseif. 
Try playing \vith the numbers, and check the API for class 
Graphics (later we'll see that there's even moreyoM can do besides 
what's in the Graphics class) . 



Displa y a J P^G 



public void paintCofl^nant (Graphics g) { ^ 

Image image = new Imagel con (""catz ilia . jpg'') . getlmage () ; 
g.drawlmage (image ; 3 , 4 , this) ; 



^ 4^ (I^l^ «»'-^y^ 




Paint a randomly-colored circle 
pn a black background 



j^ublic void paintCooponant (Graphics g) ( 



i 



g.fillReot (0, 0, this .getWidthO , this . gatHeight () ) 




) 



int red = (int) (Math. random () * 255); 
int green = (int) (Math. random () * 255); 
int blue = (int) (Math.random() * 255); 

Color randomColor = new Color (red, green, blue) 
g, setColor (rajidomColor) ; 
g.fillOval (70,70, 100; 100) ; 



i^^ ^ P'**'* 

Mi td^t 0 pixcU (tor. iU ed^r" Uc 
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behind every good Graphics reference 
isal7raphlcs2£object. 

The argument to paintComponentO is declared as type 
Graphics (java.awL Graphics). 

public void pa-intConyonent, ( Graphica g) { > 

So the parameter 'g' IS-A Graphics object Which means it 
c&uldht a it^^^rZo^ of Graphics (because of polymorphism). 
And in fact, it is. 

The object referenced by the 'g^ parameter is actually an 
instance of the Graphics2D class. 

Why do you care? Because there are things you can do with 
a Graphics2D reference that you can't do with a Graphics 
reference. A Graphics2D object can do more than a Graphics 
object, and it reaJJy is a GraphicsSD object lurking behind the 
Graphics refereace. 

Remember your polymorphism. The compiler decides which 
methods you can call based on the reference type, not the 
object type. If you have a Dog object referenced by an Animal 
reference variable: 

Anisuil a = new Do^() ; 

You can NOT say: 
a .bark () ; 

Even though you know it's reaUy a Dog back there. The 
compiler looks at 'a*, sees that it's of type Animal^ and finds 
that there's no remote control button for bark() in the Animal 
class. But you can stilJ get the object back to the Dog it really is 
by saying: 

Dog d = (Dog) a; 
d.barIcO ; 

So the bottom hne with the Graphics object is this: 

If you need to use a method from the Graphics2D class, you 
canH use the the painK^omponent parameter (^^) straight 
from the method. But you can cast it with a new GraphicsZD 
variable. 

Graphics2D g2d = (Graphic82D) g; 



Mttthods you can call on a 
Graphics reference: 

drawlmageO 

drawUne() 

drawPolygon 

drawRactO 

drawOvalQ 

flIlRectO 

flliRoundRedO 

9etColor() 

To cast the Graphics2D object to 
a Graphlcs2D referancec 

Graphics2D g2d = (Graphics2D) g; 

Methods you can call on 
a Graphtcs20 reference: 

fill3DRect(> 

draw3D Recto 

rotateO 

scaleO 

sheer() 

transformO 

setRend eilng H I n ts( ) 

t\itt\c ty>e m f 

eft n^&ftJ 



366 chapter 12 



getting gui 



because life's too short to paint the 
circle a solid color when there's a 
gradient blend waiting for you. 




pfublic void parlntCon^nent. (Graphics g) ( 
Graphic^D g2d = (GraphicaSD) g; 



4^ 



GradientPaint gradient = new GradientPaintHO , 70 , Color , blue, 150,150, Color. orange) 



g2d.aetPaint( gradient); S^^^^'^t '^^^^d a solid /:oU 
g2d.fillOval (70,70,100,100) ; 

v^Wn """^'^^ 



inblic void paintComponent (Graphics g) ( 
Graphicfl2D g2d = (Graphics2D) g; 

int red - (int) (Math . random () * 255); '^M^^ ^'^^ Ldor- ^^^^^ll 

int green = (int) (Math .random() * 255); 7ut9^''^,^l^ 
int blue = (int) (Math . random () * 255); ■ 

Color atartColor = new Color (red, green, blue); ^aA^t^^ '^^'^ 

red = (Int) (Math . random ( ) * 255); 
green = (int) (Math . random ( ) * 255); 
blue = (int) (Ma th. random 0 * 255); 
Color endColor = new Color (red, green, blue); 

GradientPaint gradient ^ new GradientPalnt (70 ,70 , startColor , 150,150, endColor); 
g2d. setPaint (gradient) ; 
g2d.fillOval (70,70,100,100) ; 
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EVENTS- 



BULUT POINTS 




To make a GUI, start with a window, usually a JFrame 

jFrame f raiDfi ^ ndw JFrame ( ) ; 

You can add widgets (buttons, text fields, etc.) to the 
JFrame using: 

frame, getContantPajneO . add (button) ; 

Unlike most other components, the JFrame doesn't let 
you add to it directly, so you must add to the J Frame's 
content pane. 

To make the window (JFrame) display, you must give It 
a size and tel) rt be visible: 

f rama . satSizQ (300,300) ; 
frame. fl a tVi a lb la (true) ; 

To know Vivien the user clicks a button {or takes some 
other action on the user interface) you need to listen for 
a GUI event. 

To listen for an event, you must register your Interest 
with an event source. An event source is the thing (but- 
ton, checkbox, etc.) that ^fires' an event based on user 
interaction. 

The listener interface gives the event source a way 
to call you back, because the interface defines the 
method(s) the event source will call when an event 
happens. 

To register for events with a source, call the source's 
registration method. Registration methods always take 
the fomi of: add<EventT/ps>Ust0ner. To register for a 
button's ActionEvents, for example, call: 
button.addActionListendr(this) ; 

Implement the listener interface by implementing ail of 
the interface's event-handling methods. Put your event- 
handling code in the listener call-back method. For 
ActionEvents, the method is: 

public void actlonParf or2nad(ActionEvant 

afv«nt) { 

button. setText ("you clicJcad!"); 

} 

The event object passed into the event-handler method 
canles Infomiation about the event. Including the source 
of the event. 



GRAPHICS 



You can draw 2D graphics directly on to a widget 

You can draw a ,gtf or .jpeg direcUy on to a v/idget 

To draw your own graphics (including a .gif or .jpeg), 
make a subclass of JPanel and override the paintCom- 
ponentQ method. 

The paintComponentQ method is called by the GUI 
system. YOU NEVER CAU- IT YOURSELF. The argu- 
ment to paintComponentQ is a Graphics object that 
gives you a surface to draw on» which will end up on 
the screen. You cannot construct that object yourself. 

Typical methods to call on a Graphics object (the paint- 
Component paramenter) are: 

graphics.satColor (Color .blue) ; 
g.fillRe<:t(20^50,100,120) ; 

To draw a jpg, constmct an Image using: 

Image imag« = new ImagaIcon(''catzilla. 
jpg'^) .getlmagaO ; 

and draw the imagine using; 

g , drawlmage (Image ,3,4, this) ; 

The object referenced by the Graphics parameter 
to paintComponentQ is actually an instance of the 
Graphics2D dass. The Graphics 2D dass has a variety 
of methods including: 

flll3DRect(). draw3DRecl(). rotate(). sceteQ. shear(). 
transfomnQ 

To invoke the Graphics2D methods, you must cast the 
parameter from a Graphics object to a Graphics2D 
object 

GraphicB2D g2d = (Graphic52D) g; 
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We can get an event. 
We can paint graphics. 

can we paint graphics whehm get an event? 

Let's h/ook up an event to a change in our drawing panel. We'll make the circle 
change colors each time you cUck the button. Here's how the program flows: 



Start the app 




The frame is built with the two widgets 
(your drawing panel and a button), A 
listener is created and registered with 
the button. Then the frame rs disployed 
and it just warts for the user to click. 



The user clicks the button and the 
button creates on event object and 
calls the listener's event handler. 



The event handler calls repaint() on the 
frame. The system colls paintComponent() 
on the drawing panel. 




Voda! A new color is pointed because 
pointComponentO runs again, filling the 
circle with a random color. 
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&UI layouts: puttina more than one 
widget on a frame 

We cover GUT layouts in the next chapter, but we'll do a 
quickie lesson here to get you going. By default, a firame 
has five regions you can add to. You can add only (me thing 
to each region of a frame, but don't panicl That one thlag 
might be a panel that holds three other things including a 
panel that holds two more things and... you get the idea. In 
feet, we were 'cheating' when we added a button to the frame 
using: 

f rama . gatContantPane ( ) . add (button) ; 



frams. gotCont«ntPana () . add (Bo rdorLayout . CENTER ^ button) 




— 



your pencil 



Given the pictures on page 351. write the 
code that adds the button and the panel to 
the frame. 
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The circle changes color each time you 
click the button. 



Import javax. fiwing . * ; 
import java.awt,*; 
import java . awt. event. * ; 



public class SixnpleGuiBC | Inqplements ActionListanar { 
JFrame frama; 



public static void main (String [] args) { 
SimploGui3C gui = now Siii5>ldGui3C () ; 
gui.goO ; 

) 

public void go() ( 

frame = new JFrame ( ) ; 

frame , aetDef aultCloseOperation (JFrame . E3CIT_ON_CLOSE) ; 




JButton button = new JButtdn ("Change colors' 
button. addActionListener (this) ; 



) 



MyDrawPanel drawPanel = new MyDrawPanel () ; 



frame . getCon tent Pane () . add (Bo rderLayout. SOUTH ^ button) ; 
frame . getContentPane () . add(BorderLayout. CENTER; drawPanel) 
fraine.setSize (300,300) ; 
frame . aetVisible (true) ; 



public void actionPerformed (ActionEvent event) ( 
frame.repaintO ; 



class MyDrawPanel extends JPanel { 

public void pa in tComponent (Graphics g) { 

// Code to fill the oval with a random color 
// See page 347 for the code 

) 



The dir^ 



the wo- 
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Let's try it with TWO buttons 



The south button will act as it does now, simply calling repaint on the 
frame. The second button {which we'll stick in tlie east region) will 
change the text on a label. (A label isjusi text on the screen.) 



So HOW we need FOUR widgets 



bbel will 
50 \\exe 




drawing panel goes 
in -tKe ttir^itr 



^lor-dKanging 
button will go K^e 




Ahd we heed to get 
TWO events 



Uhoh. 

Is tJiat even possible? How do 
you get two events when you 
have only ow^ actionPerfonned() 
method? 

T\h button tKangcs i\t tcy-t 
on tKd opposite i'dc 



0+ th^ tWcIc 
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How do you get action events for two different buttons, 
wheji each button needs to do sowethinQ different? 



^ option one 

Implement two actionPerformedO methods 

cl&afl MyGui implamantB Actionliistenar ( 
// lota of Qode hare and then: 

public void actlortP^rf ormad (ActionEvent avant) { 

^ frame, repaint 0 ; f^^i i-npo^ibl./ 

public void actionPerf orrnad (ActlonEvent avant) ( 
label, aetTaxt( "That hurt!"); 

) 

) 

Flaw: You can*tl You can't Implement the same method twice in a Java class. It won't compile. 
And even if you could, how would the event source know vjhlch of the two methods to call? 



^ option two 

Register the same listener with both buttons. 

cXaaa HyGui iznplaxnenta ActionLiatanar { 

// daclara a bunch of inatanca variablaa hare 

public void go 0 { 
// build gui 

colorButton = new JButtonO; 
labalButton = naw JButton(); 

colorButton. addActionlj.stanar(thie) ; 4ry^ Kcglit^r tK« i^^c 
labalButton. addActionLiatanar (this) / ^ botK huHctis 

// mora gui coda hara . . . 



public void actionParfonDAd<Action£vant avant) ( 

if (avant. gatSourcaO = colorButton) ( I gjh'tt^ 

fra«.repaint(); ^ ?^ wl^^^ ^^t- 

label. aetTaxt (-That hurt?") ; atWW . \\i 4-^ Ao- 

) 

Flaw; this does work| but In most cases It's not very GO. One event handler 
doing many different things means that you have a single method doing many different things, 
ff you need to change how one source Is handled, you have to mess with everybod/s event 
handler.Sometimes \tisa good solution, but usually it hurts maintainability and extensibility. 
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How do you get action events for two different buttons, 
when each button needs to do something different? 



^ option throe 

Create two separate ActionListener classes 

olaas MyGui { 
JFraiDe frazne; 
JLabal label ; 
void gui ( ) ( 

// code inatAntJ-ate the two listenttra and r*glatar one 
// with the color button and the other with the label button 

} 

) // cloa« clii^9 



claaa ColorButtonliistener iji^lements ActionListener { 
public void actionPerformed (ActionEvent event) { 
frame . repaint ( ) ; 



class LabelButtonLiataner inplementa ActionLiatener ( 
public void actionPerf onned(ActionEv©nt event) ( 
label. setText( "That hurtt"); 



) 



crer^t to t)v€ vanablc latcl' 



Flaw: these classes won't have access to the variables they need 
to act on, ^rame' and MabelWou could fix It bat you'd have to give each of the 
listener classes a reference to the main GUI class, so that Inside the actlonPerformedO 
methods the listener could use the GUI class reference to access the variables of the GUI 
class. But that's breaking encapsulation, so we'd probably need to make getter methods 
forthegul widgets (getFrame0.getLabelO,etc.). And you'd probably need to add a 
constructor to the listener class so that you can pass the GUI reference to the listener at 
the time the listener is instantiated. And, well, it gets messier and more complicated. 

There has got to be a better way! 
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Wouldn't it be wonderful rf you 
could have two different listener classes, 
but the listener dosses could access the 
instance variables of the main &UI class, 
almost as if the listener dosses belonged 
to the other class. Then you'd have the best 
of both worlds. Yeah, that would be dreamy. 
But it's just a fantasy... 
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All inner class can 
use all tli« mctlioJs 
anJ \anal>Us oi ike 
oulei* class, even llio 
private ones. 

Tlie in net* class gels 
1o use (tiose vai-ial>les 
anJ iiietlioJs jusl 
as il llie inedioJs 
and vai'iaUes were 
JeclareJ vitliin tlie 
inner class. 



Ivymr class to the rescue! 

You can have one cJa&s nested inside another. It's easy. 
Just make sure that the definition for the inner class is 
inside the curly braces of the outer class. 



Simple inner ciass: 



class MyOuterClass { 



An inner class gets a special pass to use the outer class's saiff. Even 
the privaU stuff . And the inner class can use those private variables 
and methods of the outer class as Lf die variables and members 
were defined in the inner class. That's what's so handy about inner 
classes — they have most of the benefits of a normal class, but with 
special access rights. 

Inner ciass using an outer ciass variable 

class MyOuterClass { 



private int x; 
claas MylnnfirClaas { 



X = 42; vi-— ^ 
) // close inner class 



J J< the ^r^tU^^ 



) It close cuter class 
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An inner object 
shares a special 
bond witii an 
outer object. ^ 



Ah iimer class instance must be tied to 
an outer class instance*. 

Remember, when we talk about, an inner accessing 
something in the ouier class, we're really talking about an 
imtan/e of the inner class accessing something in an instance of 
the outer class. But which instance? 

Can ^i^)^ arbitrary instance of the inner class access the methods 
and variables of any instance of the outer class? No! 

An itmer object must be tied to a specie outer object on 
the heap. 



V^^NV 



c 



^ Make an instance of 
the outer class ^ 



o 



(2) Make an instance of 
the inner class, by 
using the instance 
of the outer class. 




^ The outer and inner objects 
are now intfmately linked. 



The 



of 




There's an exception to this, for a very special case — an Inner class defined 
within a static method. But we're not go^ng there, and you might go your entire 
Java life without ever encountahng one of tliese. 
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How to make an iHstance of an inner class 

If you instantiate an inner class from code unlkm an outer class, the instance 
of the outer class is the one that the inner object will 'bond' with. For 
example, if code within a method instantiates the inner class, the inner 
object mil bond to the instance whose method is running. 

Code in an outer class can instantiate one of its own inner classes, in exacdy 
the same way it instantiates any other class... new Mylnner ( ) 



class MyOutar { , a «^watc 

private int x; ^^^^^^^ 



M/Inner iimdr = new M/Innar() 



'^«e^ chss 




public void doStuffO { 



MyOuter 



) 



void go() { 



.1^ \^]-Ari.t variable %i a* K 



) // close inner claflfl htlari^td to b\t ivwOr d-Usi- 
} // close outer claaa 



r SiJe bar" 



You can instantiafte an Inner Instance from codeainnmg outside the outer class, but you 
have to use a special syntax. Chances are you'll go through your entire Java life and never 
need to make an Inner class from outside, but just In case you're Interested... 

class Foo ( 

public static void main (String [] args) ( 
HyOutar outerObj = new MyOutar () ; 
MyOuter .Mylnner irmerObj = outarObj.new Mylniter() ; 




MyOuter 



} 



Mylnner 
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Now we can get the two-button 
code working 



public class TwoButtons { 



JFratea f ramft; 

JLabal labfil; 

/ 

y 

piiblic static void main (String [] axgs) ( 
TwoButtona gui ^ new TwoButtons () ; 
gui. go 0 ; 

} 

public void go () { 

frame = new JFrameO ; 

frame . setDefaultClosoOperation (JFrame ,EXIT_0N_CLOSE) ; 
JButton labelButton = naw JButton ("Change Label") ;J^^ 

JButton colorButton = new CJButton ('"Change Circle"); 




label new JLabelC'I'm a label"); 
MyDrawPanel dxawPanel = new MyOrawPanel () ; 

frame . getContentPane ( ) , add (BorderLayout . SOUTH , colorButton) , 
frame.getContentPane () .add (BorderLayout, CENTER, drawPanel) ; 
frame . getContentPane 0 .add (BorderLayout, EAST, labelButton) ; 
frame . getContentPane () . add (BorderLayout .WEST, label) ; 



TwoButtons 
object 



frame. setSize (300,300) ; 
frame . setViaible (true) ; 




object 



public void actionPerformed(ActionEvent event) ( 
label. setText(^^Ouchr') ; 

} // close inner class 




'--^ th^ 



public void actionPerformed(ActionEvent event) { 
frame . repaint ( ) ; 



} 

) II close inner class 



■ ihVitfr ^K-^ / 

'^^^ va.^b) tiit r.^''^ 



^olorLirfener 
object 
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Java BxposfJ 

This weeks interview: 
Instance of an Inner Class 



HeadFlrst: What makes inner classes important? 

Inner object: Where do I start? We give you a chance to 
implement the same interface more than once in a class. 
Remember, you can't implement a method more than 
once in a normal Java class. But using i«m classes, each 
inner class can implement the sanu interlace, so you can 
have all these diffemi implementations of the very same 
interface methods. 

HeadFirst: Why would you ever wmi to implement the 
same method tv\dce? 

Inner object Let's revisit GUT event handlers. Think 
about it... if you want thm buttons to each have a 
different event behavior, then use three inner classes, all 
implementing Actionlistenei — which means each class 
gets to implement its own actio nPerformed method. 

HeadFirst: So are event handlers die only reason to use 
inner classes? 

Inner object: Oh, gosh no. Event handlers are just an 
obvious example. Anytime you need a separate class, but 
still want that class to behave as if it were part of another 
class, an inner class is the best — and sometimes only — way 
to do it. 

HeadFirst: Fm still coniused here. If you want the inner 
class to behave like it belongs to the outer class, why have 
a separate class in the first place? Why wouldn't the inner 
class code just be in the outer class in the first place? 

Inner object: I just ^^i^^ you one scenario, where you 
need more than one implementation of an interface. But 
even when you're not using interfaces, you might need 
two different classes because those classes represent two 
different things. It's good OO, 

HeadFirst Whoa. Hold on here. I thought a big part of 
OO design is about reuse and maintenance. You know, the 
idea that if you have two separate classes, they can each 
be modified and used independently, as opposed to stufiing 
it all into one class yada yada yada. But with an inmr class, 
you're still just working with one real class in the end, right? 
The enclosing class is the only one that's reusable and 



separate from everybody else. Inner classes area't exactly 
reusable. In fact, I've heard them called *'Reuseless — 
useless over and over again." 

Inner object Yes it's true that the inner class is not as 
reusable, in fact sometimes not reusable at ail, because it's 
intimately tied to the instance variables and methods of 
the outer class. But it — 

HeadFirst — which only proves my point! If they're not 
reusable, why bother with a separate class? I mean, other 
than the interface issue, which sounds like a workaround 
to me. 

Inner object As I was saying, you need to think about 
IS-A and polymorphism. 

HeadFirst OK. And I'm thinking about them because... 

Inner object Because the outer and inner classes 
might need to pass diffmni IS-A tests! Let's start with the 
polymorphic GUI listener example. What's the declared 
argument rype for the buuon's listener registration 
method? In other words, if you go to the API and check, 
what kind of thing (class or interface type) do you have lo 
pass to the addActionlistenerO method? 

HeadFirst You have to pass a listener Something diat 
implements a particular listener interface, in this case 
ActionListener. Yeah, we know all this. What's your point? 

Inner object My point is that polymorphically, you have 
a method that takes only one particular fype. Something 
that passes the IS-A test for ActionListener. But — and 
here's the big thing — what if your class needs to be an IS- 
A of something that's a class rype rather than an interface? 

HeadFirst Wouldn't you have your class just extmd the 
class you need to be a part of? Isn't that the whole point 
of how subclassing works? If B is a subclass of A, then 
anywhere an A is expected a B can be used. The whole 
pass-a-Dog-where-an-Animal-is-the-declared-rype thing 

Inner object Yes! Bingo! So now what happens if you 
need to pass the IS-A test for two different classes? Classes 
that aren't in the same inheritance hierarchy? 
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HeadFirst: Oh, well you just,., hrrunm. I think Tm get- 
ting it. You can aJways implemenl more than one interface, 
but you can extend only one class. You can only be one kind 
.of IS-A when it comes to class types. 

Inner object: Well done! Yes, you can't be both a Dog 
and a Bunon. But if youVe a Dog that needs to some- 
times be a Burton (in order to pass yourself to methods 
thai take a Button), the Dog class (which extends Animal 
so it can't extend Burton) can have an inner class that acts 
on the Dog's behalf as a Button^ by extending Bunon, 
and thus wherever a Button is required the Dog can 
pass his inner Button instead of l\iniself. In other words, 
instead of saying x.takeButton(this), the Dog object calls 
x.takeButton(new MylnnerBuilonQ). 

HeadFirst Can I get a clear example? 

Inner object: Remember the drawing panel we used, 
where we made our own subclass of JPanel? Right now, 
thai class is a separate^ non-tnjier, class. And that's fine, 
because the class doesn't need special access to the instance 
variables of the main GUI. But what if it did? Wl\at if 
we're doing an animation on that panel, and it's getting its 
coordinates from the main application (say, based on some- 
thing the user does elsewhere in the GUT), In that case, if 
we make the drawing panel an inner class, the drawing 
panel class gets to be a subclass of JPanel, while the outer 
class is still free to be a subclass of something else. 

HeadFirst: Yes I see! And the drawing panel isn't reus- 
able enough to be a separate class anyway since v^^hat ii*s 
actually painting is specific to this one GUI application. 

Inner object: Yes! YouVe got it! 

HeadFirst: Good, Then we can move on to the nature of 
1 the relatwnslup between you and the outer instance. 

Inner object: What is it mth you people? Not enough 
sordid gossip in a serious topic like polymorplusm? 

I HeadFirst: Hey, you have no idea how much the public is 
I willing to pay for some good old tabloid dirt. So, someone 

creates you and becomes instandy bonded to die outer 

object, is that right? 

Inner ObJecL Yes thai*s right. And yeSj some have 
I compared it to an arranged marriage. We don*t have a say 
in which object we*re bonded to. 

HeadFirst: Alright, ril go with die marriage analogy. 
Can you get a divorce and remarry something else? 

Inner object: No, it's for life. 



HeadFirst: Whose life? Yours? The outer object? Both? 

Inner object: Mine. I can't be tied to any other outer 
object, My only way out is garbage collection. 

HeadFirst: What about the outer objecu* Can it be 
associated with any other inner objects? 

Inner obJecL So now we have it. This is what you really 
wanted. Yes, yes. My so-called 'mate* can have as many 
inner objects as it uants. 

HeadFirst: Is that like, serial monoganay? Or can it have 
tbem all at the same time? 

Inner object: All at the same time. There. Sausfied? 

HeadFirst Well, it does make sense. And let's not 
forget, it wBsyou extolling the virtues of *'muldple 
implemenudons of the same interface". So it makes seme 
that if the outer class has tliree buttons, it would need 
three different inner classes (and thus three dififerent inner 
class objects) to handle the events. Thanks for everything 
Here's a tissue. 
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Using an inner class for animation 

We saw why inner classes are handy for event listeners, because 
you get to implement the same event-handling method more 
than once. But now we*U look at how useful an inner class is when 
used as a subclass of something the outer class doesn't extend. In 
other words, when the outer class and inner class are in different 
inheritance trees! 

Our goal is to make a simple animation, where the circle moves 
across the screen from the upper left down to the lower righL 

-finish 




1 



How simple animation worlcs 

^ Paint on object at o particular x and y coordinate 
g.fillOval (20^,100,100) ; 

tio 



Rcpflrnt the object at a^diffcrent x and y coordinote 
g.fillOval (25, 55, 100, 100) ; 

f Pi^ls (rof. iKc ltd. ^ 
fi^U frcm^ "the -top 

(tKc object w^c^e6 a \iiht 



^ Repent the previous step with changing x and y values 
for OS long as the animation is supposed to continue. 



Why are we learning about 
animation here? I doubt if I'm 
going to be making games. 

-^-You might not be making 
games,butyou might be 
creating simulations, where 
things change over time to show 
the results of a process. Or you 
might be building a visualization 
tool that, for example, updates 
a graphic to show how much 
memory a program is using, 
or to show you how much 
traffic is coming through 
your load-balancing server. 
Anything that needs to take a 
set of continuously-changing 
numbers and translate them Into 
something useful forgetting 
information out of the numbers. 

Doesn't that all sound business- 
like? That's just the'offrcial 
justification* of course.The real 
reason we're covering it here is 
Just because it's a simple way 
to demonstrate another use 
of Inner classes. (And because 
we Just ///ce animation, and our 
next Head First book is about 
J2Ee and we /enow we can't get 
animation in that one.) 
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What we really want is something like... 




!las5 bfyDrawPanel extends JPanel { 

public void paintCoa5>onent (Graphics g) { 



g« aetColor (Color. orange) ; 
g.flllOval (x,y,100,100) ; 





irpen your 



But where do we get the new x and y 
coordinates? 

And who calls repaint()7 

See ff you can design a simple solution to get the ball to animate from the top left of the 
drawing panel down to the bottom right Our answer Is on the next page, so don't turn 
this page until you're done! 
Big Huge Hint make the drawing panel an inner class. 

Another Hint don't put any kind of repeat loop In the palntComponentO method 
Write your (deas (or the code) here: 
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complete simple animation code 



inyort javax. swing ; 
ln^rt javA.awt.*; 



public claafi StnrplttAnJjmation { 



int X = 70 
int y = 70 



,^ A,, I Mass. 



public static void main (String [] args) { 

SimplaAnimation gui = naw Siiapl«AnijDation (); 

gui.goO ; 

} 

public void go() ( 

JFrama frama = n«w JFrame() ; 

frame . sotDaf aultCloseOpdration ( JFrame . HXIT_ON_CL03E) ; 
MyDrawPan«l drawPajnal = new MyDrawPanel () ; , 



''^9 hew h^. ^ . . 



«r»M.g«tCont«atPan«() .«Mld(drat»P*n«l) ; '"™ P«rt then, f 

frama.MtSize (300,300) ; 
frame . satVisible (true) ; 




lee iw* 



6an *M ' 

I. 



•SU t dow. , li^e (ci^er^uc will ^ 



\ic^ class MyDrawPaxiel extends JPanol { 

public void paintCon^onent (Graphics g) 
g.setColor (Color .green) ; 
g.fillOval(x,y,40,40) ; 



^d^^i^, o( ill r , 



y // clo5a iiuiBr clasa 
} // cloae outer class 
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Uh-oh. It didn't move... it smeared. 

What didjNE do wrong? 

There's one little fkiw in the paintComponentO 
method. 

We forgot to erase what was 
already there! So we got trails. 

To fix it, all we hove to do is fill in the entire panel with 
the background color, before painting the circle each 
time. The code below odds two lines at the fftart of the 
method: one to set the color to white (the background 
color of the drawing panel) and the other to fill the 
entire panel rectangle with that color. In English, the 
code below says, "Fill a rectangle starting at x and y of 
0 (0 pixels from the left and 0 pixels from the top) and 
make it as wide and as high as the panel is currently. 





publio void paintCoo^xinerLt (Graphics g) { 
g.setColor (Color. white) ; 

g.fiJ.lRect(0|0,thia,g«itWidth() , this .getHeigbt () ) ; 

g . aetColor (Color . gr«6xi) ; ^ I 

g.fillOvAl(x,y,40,40) ; 5e^'dhO ge^Hei-ihtO 



) 



Sharp your pencil (optional, just for Fun] 



What changes would you make to the x and y coordinates to produce the animations below? 
(assume the first one example moves In 3 pixel increments) 



start 



finish 



start 



finish 



start 



finish 



X +3 



Y +^ 



X 
Y 



X 
Y 



start 



finish 



X 

Y_ 

X 
Y 



start 



finish 



X 
Y 



start 



finish 
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Code Kitcken 



i 








t>4A,M-. . . 








■ 









































Let s make a music vkleo. Wfell use Java-generatcct rancloiii 
^rapkks tkat keep time wrtk tke music Leats. 

Along tkc way veil register (ami listen W) a new kind <rf 
non-GUI event, triggered ky tke music itseli. 



Rcn»C*nW> t^il f>a^ is all o{4;ioy\3!. But tKink ii's g«>od -for you 

A^d you'll liktf it And you U^w. \k.kx> it^press people 

((Jk, lurc, it miftVit work oTkly on people vuKo ire really easy to ii^prcis, 
but still.-) 
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ListeHlrrg for a non-frUI event 

OK, maybe not a music video, but we mil make 
a program that draws random graphics on the 
screen with the beat of the music. In a nutshell, 
the program listens for the beat of the music 
and draws a random graphic rectangle with each 
beat. 

That brings up some new issues for us. So far, 
we've listened for only GUI events, but now 
we need to listen for a particular kind of MIDI 
event. Turns out, listening for a non-GUI event is 
just like listening for GUI events: you implement 
a listener interface, register the listener with an 
event source, then sit back and wait for the event 
source to call your event-handler method (the 
method defined in the listener interface). 

The simplest way to listen for the beat of the 
music would be to register and listen for the 
actual MIDI events, so that whenever the 
sequencer gets the event, our code will get it 
too and can draw the graphic* But... there's a 
problem. A bug, actually, that won't let us listen 
for the MIDI events a^^Vs? making (the ones for 
NOTE ON). 

So we have to do a little work-around. There 
is another type of MIDI event we can listen 
for, called a ControllerEvent. Our solution 
is to register for ControllerEvents, and then 
make sure that for every NOTE ON event, 
there's a matching ControllerEvent fired at 
the same *beat'. How do we make sure the 
ControllerEvent is fired at the same time? We 
add it to the track just like the other events! In 
other words, our music sequence goes like this: 

BEAT 1 - NOTE ON, CONTROLLER EVENT 

BEAT 2 -NOTE OFF 

BEAT 3 - NOTE ON, CONTROLLER EVENT 
BEAT 4 -NOTE OFF 
and so on. 

Before we dive into the full program, though, 
let's make it a little easier to make and add MIDI 
messages/events since in this program, we're 
gonna make a lot of them. 



What the music art program 
needs to do: 



Make a series of MIDI messages/ 
events to play random notes on a piano 
(or whatever instrument you choose) 

Register a listener for the events 

Start the sequencer playing 

Each time the listener's event 
handler method is called, draw a 
random rectangle on the drawing 
panel, and call repaint. 



We'll build it in three iterations: 

0 Version One: Code that simplifies mak- 
ing and adding MIDI events, since we'l 
be making a lot of them. 

^ Version Two: Register and listen for 
the events, but without graphics. 
Prints a message at the command-line 
with each beat. 

^ Version Three: The real deal Adds 
graphics to version two. 
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Ah easier way to make 
messages / events 

Right now, making and adding messages and 
events to a track is tedious. For each message, 
we have to make the message instance (in this 
case, ShortMessage)i call setMessage(), make a 
MidiEvent for the message, and add the event 
to the track. In last chapter's code, we went 
through each step for every message. That 
means eight lines of code just to make a note 
play and then stop playing! Four lines to add a 
NOTE ON event, and four lines to add a NOTE 
OFF event 

ShortMaaaage a = new ShortMeasage () ; 

a, BatMea3age(144^ 1, nota, 100); 
MidiEvent not«On = new MidiEvent (a, 1) ; 
track. add (noteOn) ; 

Sht^rtMaasage b = new ShortHeasage () ; 

b. aetMaasage (128, 1, note, 100); 
MidiEvent noteOff = new MidiEvent (b, 16) 
tracJc.add(noteOff ) ; 



Things that have to happen for 
each event: 

Make a message instance 

ShortMeasage firat new ShortMesaage () ; 



Call setMessageO with the instructions 

firflt.aetMessage(192, 1, inatnTment^ 0) 

Make o MidiEvent instance for the message 

MidiEvent noteOn = new MidiEvent (firat, 1) ; 

Add the event to the track 

track. add (noteOn) ; 



Let's build a static utiiity method that 71,^ <^^^. 

malces a message and returns a iVIidiEvent c^y a^^^^^ ^B} J iWis ^^^7 

public atatic MidiEvent maJceEvent <int comd; int chan, int one, int t%ro, iixt ticJc) { 
MidiEvent event = null ; ^ ^.^ ^.^^ ^ a.a^^- 

try { 

ShortMesaage a = new ShortMesaacre 0 ; J 
a.setHassaae (comd, chan, ona, two); 

event = new MidiEvent (a, tick) ; ( ^ '»^^i>iod pJi-j,*,^^ ^''^^i Ujing 

) catch (Exception e) { ) 

«tum -ent;^ ^^^^^ ^^^^ ^-^.e^^,^ ,1| 
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Example: how to use the new static 
niakeEveHtO method 

There's no event handling or graphics here, just a sequence of 15 
notes that go up the scale. The point of this code is simply to learn 
how to use our new makeEventO method. The code for the next 
two versions is much smaller and simpler thanks to this method. 

ixi5>ort javax . sound . midi . * ; ^ do» V / 

pxablic class MiniMusicPlayerl { 

public static void main (String [] args) { 
try ( 

Sequencer sequencer = MidiSystem.getSequencer () ; ^3\cc 
sequencer . open ( ) ; 

Sequence seq = new Sequence ( Sequence. PPQ, 4) ; ^ ^dke d se<\uen6e 

Track track = seq . createTrack ( ) ; 4—""' — ^ ^ htatk 

for (int i « 5; i < 61; i+= 4) { t---make d h^^U\s o( mnls to »«dkc iht notes kecf 

5oir>5 uf ((r<m fiBno vscU ^ to fidno note 

track. add (maUceEvent (144, l,i, 100, i) ) ; ^ n 

sequencer. setSequence (seq) ; 1 
sequencer . setTen5>olnBPM(220) ; \ ^taH: it minihg 
sequencer . start ( ) ; / 
} catch (Exception ex) { ex. prints tackTrace (); } 

} // close main 



public static MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new Shortlfessage () ; 
a.setMessage(comd, chan, one, two); 
event = new MidiEvent (a, tick) ; 

} catch (Exception e) { } 
return event; 

} 

) // close class 



you are here > 389 



controller events 



Versioifi Two: registerihg ahd gettihg CoHtroIlerEvents 

import javax. sound, midi.*; ^^^^^^^^^^^^^^^^^^^^^^^^^ 
ptiblic class MiiilMuaicPlayer2 ^^^^^^^^^^^^^H^^^^^H^^^^^H ^ 



public static void main (String [] arga) ( 

MiniMusicPlayer2 mini = new MiniMiiflicPiayar2 () ; 

mini. go {) ; 

} 

public void go() { 
try { 

Sequencer sequencer = MidiSyatam.getSequencer () 
sequencer , open ( ) ; 



intCl 




Sequence seq = new Sequence (Sequence . PPQ, 4) 
Track track = seq. createTrack () ; 

for (int i = 5; i < 60; i+= 4) ( 

track. add (makeEvent (144, l,i, 100, i) ) 



track.add(makeEvent(128,l;i;100,i + 2)); 
} // end loop 

sequencer. setSequence (seq) ; 
sequencer ,setTempoInBPM (220) ; 
sequencer . start ( ) ; 
} catch (Exception ex) (ex .prints tackTraca (); } 
) // close 



publics void OTptmlC3uyag«(ShCMrtiieaMge jmnth.i 



Lett's Kow wtf pidic up h^e iy^Ai 



public MidiEvent makeEvent (int corod, int chan, int one, int two, int tick) ( 
MidiEvent event = null; 
try ( 

ShortMaasage a » new ShortMesaage () ; 
a. setMessage (comd, chan, one, two) ; 
event = new MidiEvent (a, tick) ; 



) catch (Exception e) { } 
return event; 



Code that's different from the previous 
version is highlighted in gray, (and we're 
not running it oil within mainQ this time) 



) 

) // close class 
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Version Three: drawing graphics in time with the music 

This findi version builds on version two by adding die GUI parts. We build a 
firame, add a drawing panel to it, and each time we get an event, we draw a 
new rectangle and repaint the screen. The only other change from version 
two is that the notes play randomly as opposed to simply moving up the 
scale. 

The most important change to the code (besides building a simple GUI) 
is that we make the drawing panel implement the ControUerEventListener 
rather than the program itself. So when the drawing panel (an inner class) 
gets the event, it knows how to take care of itself by drawing the rectangle. 

Complete code for this version is on the next page. 



The drawing panel inner class: 



class MyDrawPanel extends JPanel ixsplements ControUerEventListener { 
boolean msg = false; 



to tt^ ohiy wKeh we jei an eveni 



public void controlChangs (ShortMassaga avant) ( 
msg = trua; 

rapaintO ; 1^ . f« ^ a»» evc«i so we id; the (U h> 

) t<rue and Mil vcfaihtO ^ 

public void paintConponant (Graphics g) { 
if (msg) { w 



Graphics2D g2 = (Graphics2D) g; 



int r = (int) (Math . random ( ) * 250); 
int gr = (int) (Math . random () * 250); 

int b = (int) (Math . random ( ) * 250); « ^odc to jey^cv-ate 

g . setColor (new Color (r , gr , b) ) ; s€mi«rahdo^ ^cdtanjle, 

int ht = (int) ( (Math . random () * 120) + 10); 
int width = (int) ( (Math . random ( ) * 120) + 10); 
int X = (int) ( (Math . random ( ) * 40) + 10); 
int y = (int) ( (Math. random () * 40) + 10); 
g.fillRect(x,y,ht, width); 
msg = false; 



} // close if 
} // close method 
} // close inner class 



you are here ► 391 



MiniMusicPlayerS code 




This is the complete code listing for Version 
Three. It builds directoy on Version Two. Try 
to annotate it yourself, without looking at the 
previous pages. 



in^or t j avax . soiind . midi . * ; 
import java.io.*; 
import j avax . swing , * ; 
import j ava . awt . * ; 



public class MiniMusicPlayerS { 

static JFraroe f = new JFrame("My First Music Video"); 
static MyDrawPanel ml; 

public static void main (String [] args) ( 

MiniMusicPlayer3 mini = new MiniMusicPlayerS () ; 
mini . go ( ) ; 

} // close method 



public void setUpGuiO { 
ml = new MyDrawPanel ( ) ; 
f . setContentPane (ml) ; 
f.setBounds (30,30, 300,300); 
f ,setVisible(true) ; 
) // close method 

public void go() { 
setUpGui ( ) ; 



Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer . open ( ) ; 

sequencer , addControllerEventListener (ml , new int [ ] { 127 } ) ; 
Sequence seq = new Sequence (Sequence. PPQ, 4); 
Track track = seq.createTrackO ; 

int r = 0; 

for (int i = 0; i < 60; i+= 4) { 

r = (int) {(Math. random 0 * 50) + 1); 
track . add (makeEvent (144 , 1 , r , 100 , i) ) ; 
track. add (makeEvent (176,1,127,0,1) ) ; 
track. add (makeEvent (128, l,r, 100, i + 2)); 
} // end loop 

sequencer. setSequence (seq) ; 
sequencer . start ( ) ; 
sequencer . setTempoInBI^(120) ; 
} catch (Exception ex) { ex. prints tackTrace () ;} 

} // close method 



try { 
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A bunch of Java hot-shots, io full costume, are playing the party game "Who 
am \r They give you a ciue, and you try to guess who they are, based on 
what they say. Assume they always tell the truth about themselves. If they 
iRfitS^ happen to say something that could be true for more than one guy, then 

write down all for whom that sentence applies. Fill In the blanks next to the 
sentence with the names of one or more anendees. 



Tonight's attendees: 

ami? Any of the charming personalities from this chapter just 
* might show upl 



I got the whole GUI, In my hands. 

Every event type has one of these. 

The listener's key method. 

This method gives JFrame its size. 

You add code to this method but never call It 

When the user actually does something, it's an 

Most of these are event sources. 

I carry data back to the listener. 

An addXxKListener( ) method says an object is an . 

How a listener signs up. 

The method where all the graphics code goes. 

I'm typically bound to an instance. 

The 'g' in (Graphics g), Is really of class. 

The method that gets paintComponent( ) rolling. 

The package where most of the Swingers reside. 
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import javax.swing,*; 
import java.awt, event.*; 
import java.avrt.*; 

class IrmerButton { 

JFrame frame; 
JButton b; 



getting gui 



BE the com]fileT 

Java file on this page represents a 
coiig»lete source file. Your job is to plaV 
coTt^^iler anH dBt^Tv6J^e ^edier iliis file 
^11 compile. If it won't compile, Kow 
woald you fix tt, and if it does 
compile, what would it do? 




public static void main (String (] args) { 
InnerButton gui = new InnerButton( ) ; 
gui.goO; 

> 



public void go( ) { 
frame - new JFrame(); 
frame. setOefaultClo360peratioii( 

JFrame.EXIT_ON_CLOSE) ; 



b = new JButton (^A"); 
b,addActionListenei{ ) ? 



frame • getContentPane ( ) * add ( 

BorderLayout . SOUTH , b ) ; 
frame,3etsi2e(200,100); 
frame . aetVisible ( true ) ; 

} 

class BListener extends ActionListener { 
public void actionPerfonned(ActionEvent e) { 
if (b.getTextO .equals^A")) { 

b.setText("B''); 
} else ( 
b.setText{^A''); 

) 

} 

} 

you are here ► 395 



getting gui 



Exercise Solutions 



Who am I? 

I goi the whole GUI, in ray hands. 

'Bvery event type has one of these. 

the listener's key method. 

This method gives JFrame its size. 

You add code to this method but 
f'liever call it. 

When the user actually does 
mething, it's an 

lost of these are event sources. 

[ carry data back to the listener 

I addXxxListener( ) method 
ays an object is an 

iow a listener signs up. 



The method where all the 
graphics code goes. 



'm typically bound to an instance. 

e 'g" in (Graphics g), is 
ly of this class. 

e method that gets 
tCoraponent( ) rolling. 



The package where most of the 
Angers reside. 




JFrame 

\\si^r\tr interface 
actionPcrf ormed( ) 
setS(2e( ) 

pQintCompone/it( ) 

event 

swing components 
event object 

event source 
addActionListener( ) 

paintComponent( ) 
inner cIqs5 

Sraphics^d 

repamt( ) 

jQVQX.swing 



Once thr5 code 
Is fixed, it will 
create a GUI with 
a button that 
toggles between 
A and B when you 
click it 



BE com^ffler 



import javax»swiDg«*; 
import java»awt. events*; 
import java.awt.*; 

class InnerButton { 

JFrame tram; 
JButton b; 



public static void inaiii(String [] arga) { 
InnerButton gui - new rnnerButton( ) ; 
gui.goO; 

) 

public void go( ) { 
frame = naw JFram6{J; 
frame » setDef aultClofleOperatlon ( 

JFrame. EXIT ON CLOSE); 



The addActionListener( ) 
method takes a class that 
implements the ActionLis- 
tener interface 



b = new JButton ("A"); 
b.addActionI.iatener{ WW PUtteMrl ) ) ; 

frame.getCoDteatPane( ) .add( 

&orderLayout»SODTH, b); 
frame.8etSi2e(200,100l ; 
frame* setVisible( true ) ; 



} 



class Bliistener ActionListener { 

public void actionPer formed (Action£vent e) { 
if (b.getTextO. equals ("A")) { 
b.satText(-B'); 



\ elae { 
b.setTextCA"); 



ActionLiStener is an 
interface. Interfaces 
are implemented, not 
extended 
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puzzle answers 




f^l puzz]e 



The Axnazing, Shrinking, Blue 
Rectangle. 




import javBJC. swing, * ? 
import java.awt.*; 
public class Animate { 

int X - 1; 

int y = 1; 

public static void main (String[] args) { 
Animate gui = new Animate ( ) ; 
gui . go ( ) ; 

} 

public void go( ) { 

JFrame frame = new JPraine(); 
frame » setDef aultCloseOperation ( 

JFrame . EXIT_ON_CLOSE ) ; 

MybrawP drawP = new MyDrowPQ; 

f rame.getContentPaneC ) .add(drawP) ; 

f rQme.set5ize(500,270) ; 

frQme*setVi8ible(true) ; 

for (int i = 0; i < 124; r^-*'Pf+^-,y++ ) { 

drawP.repQintO; 

try { 

Thread, sleep(50 ) ; 
} catch (Exception ex) { > 

} 

} 

class MyDrawP extends JPanel { 

public void paintComponent (Graphics g ) { 
g.sctColor(Color.white); 
g.fillRect(0A500,250); 
g.setColor(Color.blue); 
g.fillRect(x.y,500-x*2,250-y*2); 



} 
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13 using swing 



Work on Your 

SwiHi' 



Why won't 
the ball go where Xwont 
it to go? (like, smack in Suzy 
,C^S Smith's face) Fve gotta learn 
to controf it. 




Swing Is 6dSy. unless you actualiy care where things end up on the screen. Swing code 
looks easy, but then you compile it, run It, look at it and think, "hey, that's not supposed to go 
there." The thing that makes it ea5y to cot^e Is the thing that makes It hard to confro/— the 
Layout Manager. Layout Manager objects controf the size and location of the widgets in a 
Java GUI. They do a ton of work on your behalf, but you won't always like the results. You want 
two buttons to be the same size, but they aren't. You want the text field to be three inches long, 
but It's nine. Or one. And t/ntrferthe (abel instead of next to it. But with a little work, you can get 
layout managers to submit to your will. In this chapter, we'll work on our Swing and in addition 
to layout managers, we'll learn more about widgets, We'll make them, display them (where we 
choose), and use them In a program. It's not looking loo good for Suzy. 
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components and containers 

Swihg compohehts 

Component is the more correct term for what we*ve been calling a xmdgeL 
The things you put in a GUI. The things a user sees and interacts luiik Text 
fields, buttons, scrollable lists, radio buttons, etc. are all components. In 
fecu they all extend javax. swing. JCo(ii5>onQnt. 

Cowponeiits cah be nested 

In Swing, virtually aZ/ components are capable of holding other 
components. In other words, you can stick just oboiU anything into anything 
else But most of the time, you'll add user interactive compontnxs such as 
buttons and lists into background componeots such as firames and panels. 
Although ii*s possible to put, say, a panel inside a button, that's pretty 
weird, and won*t win you any usability awards. 

With the exception of JFrame, though^ the distinction between interactive 
components and background cova^ontnXs is artifidaJ. AJPanel, for 
example, b usually used as a background for grouping other components, 
but even a JPanel can be interactive. Just as with other components, you 
can register for the JPaners events including mouse clicks and keystrokes. 

Four steps to making a GUI (review) 

^ Make c window (a JFrame) 

JFraska framA >= new JFrame () ; 

0 Make q component Cbutton, text field, etc.) 

JButton button aaw JBut ton ("elicit mo"); 

^ Add the component to the frame 

frama.getCcntAntPan&O . add (BordarLayout. EAST, button) ; 

^ Display it (give it a size and moke it visible) 

frame. s^tSize (300,300) ; 
frame . setVisible (true) ; 

Put Interactive components: Into background components: 



A wi Jget is tecknically 
a Swing Cain£ Onent> 
Almost every tking 
you can stick in a 
GUI extemts irom 
javax*swing.JComponent. 
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Layout Managers 



A layout manager is a Java object associated 
with a particular component, almost always a 
background component The layout manager 
controls the components contained unthin the 
component the layout manager is associated 
v.ith. In other words, if a frame holds a panel, 
d the panel holds a button, the paners layout 
anager controls the size and placement of 
the button, while the frame's layout manager 
ntrols the size and placement of the 
nel. The button, on the other hand, 
doesn't need a Layout manager because the 
button isn't holding other components. 

[fa panel holds five things, even if those 

things each have their own layout 
managers, the size and location of the five 
tilings in tiie panel are all controlled by the 
el's layout manager If those five things, 
in ttim, hold other \hin^, then those other 
gs are placed according to the layout 
ager of the thing holding them. 

en we say holdw^ really mean add as in, a 
panel haldsz button because the button was 
odded to the pane] using something like: 

arjrPanel .add (button) ; 

Liayout managers come in several flavors^ and 
■Ejach background component can have its own 
rtiyout manager. Layout managers have their 
own policies to follow when building a layout 
for example, one layout manager might insist 
dliat all components in a panel must be the same 
, arranged in a grid, while another layout 
anager might let each component choose its 
mm size, but stack them vertically Here's an 
^example of nested layouts: 

JPanal panelA - new JPanel ( ) ; 
jPanol panels new JPanel ( ) ; 
panels . add (new JButton (^'button 
panels, add (new JButton (''button 
panels, add (new JButton ('^button 
panelA. add (panels) ; 



using swing 



As a layout manager, 

I'm in charge of the si2e 
and placement of your components. 
In this I'm the one who de^cidzd 
how big these buttons should be, and 
where they are relative to each 
other and the frame. 





■iffnTlfini^"itir 



1")) 

2")) 
3")) 



^«t*a >.,iK.h ihosi added tompo«i4. ^ 
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layout managers 



How does the layout manager decide? 

Different layout managers have different policies for arranging 
components (like, arrange in a grid, make thera all the same size. 
Slack them vertically, etc.) but the components being layed out do 
get at least samesrozll say in the matter. In general, the process of 
laying out a background component looks something like this; 



A layout scenario: 

^ Make a panel and add three buttons to it. 

@ The panel's layout manager asks e^ich button'how big 
tl^at button prefers to be. 



® The panel's layout manager uses its layout policies to decide 
whether ft should rtspect all, part, or none of the buttons' 
preferences. 

@ Add the paneJ to o frame. 

@ The frame's layout manager asks the paneJ how big the panel 
prefers to be. 

® The f rame*S layout manager uses its layout policies to decide 
whether it should respect all, part, or none of the panel's 
preferences. 

different layout managers have different policies 

Some layout managers respect the size the component wanes to 
be. If the button wants to be 30 pixels by 50 pixels, that*s what the 
layout manager allocates for that button. Other layout managers 
respect only part of the component's preferred size. If the button 
wants to be 30 pixels by 50 pixels, it'll be 30 pixels by however 
wide the button*s background panelis. Soil other layout managers 
respect the preference of only the largest of the components 
being layed out, and the rest of the components in tliat panel 
are all made that same size. In some cases, the work of the layout 
manager can get very complex, but most of the time you can 
figure out what the layout manager will probably do, once you get 
to know that layout manager's policies. 
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using swing 



The l^ig Three layout managers: 
border flow, and box. 



BorderLayout 

A BorderLayout rxscmgzr divides a background 
component into five regions. You con add only one 
component per region to a bQcl<ground controlled 
by a BorderLayout manager. Components laid out 
by this manager usually don't get to have their 
preferred size, BorderLayout Is the default layout 
manager for a fromel 



FlowLayout 

A FlowLayout manager acts kind of like a word 
processor, except with components instead of 
words. Each component is the size it wants to be, 
and they're lord otrt left to right in the ordCrF that 
they're added, with "word-wrap" turned on. So 
when Q component won't fit horizontaliy, it drops 
to the next "line"* in the layout. FlowLayout Is the 
default layout manager for a panel I 



^ w when 



BoxLayout 

A BoxLayout manager is fike FlowLayout in that 
each component gets to have its own size, and 
the components are placed m the order in which 
they're added. But, unlike FlowLayout, a BoxLayout 
manager can stack the components vertically (or 
horizontally, but usually we're just concerned with 
vertically). It's like a FlowLayout but instead of 
having automatic 'component wrapping', you can 
insert a sort of ^component return key and force 
the components to Start a new line. 




\ 



you are here > 403 



border layout 



BorderLayout cares 
about five regions: 

east, west, nortli, 

south, and center 



Let's add a button to the east region: 

Ijnport javax . swing . • ; , ^ava awt Vitka^e 

import java . awt . * ; ^ ?><^ierU^'^^ ^ ' 

public class Buttonl { 

public static void nuiin (Stxing[] axgs) { 
Buttonl gui = naw Buttonl <) ; 
gui.goO ; 

} 

public void go() ( .0 
JFrama frama = now JFrama{) ; ^^V^''^ ' 

JButton button = new JButton ("^cllck ma"); ^ 
frana . gatContantPana 0 .add (BorderLayout. EAST, button) ; 
f ram . setSize (200 , 200) ; 
f rama . satVisibla (true) ; 

) 




Brain Barbell 



How did the BorderLoyout manager come up with 
this size for the button? 



What are the factors the layout manager has to 
consider? 



Why (sn't it wider or taller? 









\ 








click me 
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using swing 



Watch what happens when we give 
the button more characters... 



public void go 0 ( 

JFrajne frame - new JFrame 0 ; 
JButton button = new JButton (''clicy iika you mean it"); 
frame . getConcentPane () . add (BorderLayout . EAST, button) ; 
f rame- setSize (200, 200} ; 
frame. setvisible {true) ; 



) 
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border layout 



Let's try a button in the NORTH region 



public void go () { 

JFrame frame = new JTrameO; 

JButton button = new JBut ton ("'There is no spoon. . .") ; 

frame . getContentPane ( ) - add (BorderLayout . WORTH , button) ; 
frame, setSize (200, 200) ; 
f rame.se tvisible (true) ; 



} 




Now let^s make tiie button ask to be taller 

How do we do that? The button is alrcody as wide 
OS it can ever be— as wide os the frame. But we 
can try to moke it taller by giving it a bigger font. 



public void go () ( 

JFrame frame = new JFrameO; 

JButton button = new JButton (""Click IThia!"); 
Font bigFont = new Font (""serif", Pont. BOLD, 28); 
button.aetFont{bigFont) ; 

frame . getContentPane ( ) .add (BorderLayout .NORTH; button) . 
frame. setSize (200, 200) ; 

frame . setvisible (true) ; 



Click Thisr^ 
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I think rm getting it... if Tm in east or 
west, I get my preferred width but the 
height is up to the layout rwcm^er. And 
if Tm \n north or south, if s just the 
opposite— I get my preferred height, but 



not width. 



^^^^ 



Birt vltat liappeiis 
in tke cente r region? 



The center region gets whatever"& leftl 

(except in one special case we'll look at later) 

public void go () { 

JFrame frame - new JFraxneO; 

JButton east ^ new JButCon ("East" ) ; 

JButton west = new JButton (""West") ; 

JButton north = new JButton ("North" ) ; 

JButton south = new JButton ("South") ; 

JButton center = new JButton (""Center") ; 

fraine,getConcencPane () . add (BorderLayout , EAST, east) ; 
frame. getContentPaneO . add (BorderLayout .WEST, west) ; 
f rame.gecContentPane 0 . add (BorderLayout , NORTH/ north) ; 
frame.getContentPaneO .add (BorderLayout . SOUTH, south) ; 
frame . gecContentPane () , add (BorderLayout .CENTER, center} ; 

frame. aetSiza (300, 300) ; 
frame , setvisible (true) ; w 
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flow layout 



— FlowLayout cares 

d]0 about the flow of the 
0(r^ tirS) components: 

(^EQ J left to right, top to bottom, in 
the order they were added. 



Let's add a panel to the east region: 



A JPanel's layout manager i5 FlowLayout, by default. When we odd 
a panel to a frame, the size and placement of the panel is Still 
under the BorderLayoat manager's control. But anything Inside the 
panel (in other words, components added to the panel by colfmg 
panel . add (aComponent) ) are under the panel's FlowLayout 
manager's control. Well stort fay putting an empty panel in the frame's 
eofft region, and on the next pages we'll add things to the panel. 



iTTTport javAJi . awing. * ; 
Import java.awt,*; 

public class Panell { 

public static void main (StxingI] args) 
Panell qui = now PanelK); 
gui,go() ; 

} 




' 0 ' y^Maict iMt yar.e\ yr^y so tar. s,^ 



public void go() { 

JFrame frame » new JFrame() ; 
JPanel panal ~ new JPanel ^ 
panel. setBackground (Color. dar]cGray) ; 
frankfi . getContentPane 0 .add(BorderI«ayout.EAST/ panel) ; 
frania.setSize(200,200) ; 
fraxsae . setVisible (true) ; 



} 
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using swing 



Let's add a button to the panel 

public void go () { 

JFrame frame - new JFraxne () ; 
JPanel panel = new JPanel () ; 
panel , setBackground (Color . darJcGray) ; 

JButton button - new JButton ("shock me^') 



panel , add (button) ; 
frame.getContentPaneO . add (Border Layout . EAST, panel) ; 

frame. setSi2e (250, 200) ; 
frame, setVisible (true) ; 



.,.c\ io f-*:'- Till 



see J 


«6& 1 








f shock me J 



















And ^« b^ttor, g^i 




The frame's 
BorderLayout manager 



The panel's 
FlowLoyout manager 
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flow layout 



What happens if we add TWO buttons 
to the panel? 

public void goO I 

JFrajrte frame - new JTrameO; 
JPanel panel = new JPanel () ; 
panel . setBackground (Color .darJcGray) ; 

JButton button = new JButton (^^shock me"); . 
JButton buttonTwo = new JButton ('"bliss") ; 

panel , add (button) ; 



panel, add (buttonTwo) \ ^ OOT^ 



frame.getContentPaneO . add (BorderLayout . EAST, panel) 
f rame .setSize (250, 200) ; 
frame . setvisible (true) ; 



what we wanted^ 



of ti^ 



what we got: 



^1 



side, 




rpen your pencil 



If the code above were modified to the code below, 
what would the GUI look like? 

JButton button = new JButton ("shock me") ; 
JButton buttonTwo = new JButton (""bliss") ; 
JButton buttonThree = new JButton ("'huh?") ; 
panel , add (button) ; 
panel .add (buttonTwo) ; 
panel , add (buttonThree) ; 




Draw what you 
thtnktheGUI would 
look like if you ran 
the code to the left. 

(Then try Itl) 
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a 



BoxLayout to the rescue! 

It keeps components 
stacked, even if there's room 
to put them side by side. 



Unlike FlowLayout, BoxLayout can force a 
'new line' to make the components wrap to 
the next line, even If there's room for them 
to fit horizontally. 



But now you'll have to change the panel's layout manager from the 
default FlowLoyout to BoxLayout. 



public void go () { 

JFrame frame = new JFrameO; 
JPanel panel = new JPanelO; 
panel -setBackground (Color .darkGray) ; 



panel . setLayout (new BoxLayout (panel , BoxLayout . Y__AXIS) ) ; 



JButton button - new JButton (^^shock me"); 
JButtan buttonTwo = new JButton ("bliss") >* 
panel. add (but ton) ; 
panel -add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . ZhST, 
frame -setSize (250, 200) ; 
f rame.setvisible (true) ; 



panel) ; 
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DioSl^tJuestjons 

How come you can't add directly to a frame the way 
you can to a panel? 

J^l A JFrame Is special because it's where the rubber 
meets the road In making something appear on the screen. 
While alt your Swing components are pure Java^a JFrame 
has to conr^ect to the underlying OS in order to access the 
display. Think of the content pane as a 1 00% pure Java layer 
that sits on top of the JFrame. Or think of it as though JFrame 
is the window frame and the content pane Is the... glass. You 
know, the window pone. And you can even swap the content 
pane with yourown JPanel^to make yourJPanel the frame's 
content pane, using, 

inyFrazDA . aetContantPane <znyPan«l) ; 

Can I change the layout manager of the frame? 
What If I want the frame to use flow Instead of border? 

-/\^!The easiest way to do this is to make a panel, build 
the GUI the way you want In the panel, and then make that 
panel the frame's content pane using the code in the previ- 
ous answer (rather than using the default content pane). 

Q,- What If I want a different preferred size? Is there a 
setSlzeO method for components? 

-^lYeSy there is a setSize(), but the layout managers will 
Ignore ftThere's a distinction between the preferred size of 
the component and the size you want It to be.The preferred 
size is based on the size the component actually needs 
(the component makes that decision for itself).The layout 
manager calls the component's getPreferredSizeO method, 
and that method doesn't care if you've previously called 
setSizeO on the component. 

Can't \ just put things where I want them? Can I turn 
the layout managers off? 

Yep. On a component by component basis, you can call 
aat:Layout<null) and then it's up to you to hard-code 
the exact screen locations and dimensions. In the long run, 
though, It's almost always easier to use layout managers. 



BULUI POINTS 

■ Layout managers control the size and location of 
components nested within other components. 

■ When you add a component to another component 
(sometimes refen^ed to as a background componenl 
but thaf s not a technical distinction), the added 
component is controlled by the layout manager of the 
backgroijnd componenL 

■ A layout manager asks componerrts for their 
preferred size, before making a decision about 
the layout. Depending on the layout manager's 
polides, it might respect all, some, or none of the ' 
component's wishes. 

■ The BorderLayout manager lets you add a i 
component to one of five regions. You must specify 
the region when you add the component, using the 
following syntax: , 
add (BorderLayout . EAST, panel ) ; ' 

■ With BorderLayout, components in the north and 
south get their preferred height but not width. 
Components In the east and west get their preferred 
width, but not height The component in the center 
gets whatever is left over (unless you use pack ( ) ). 

■ The packO method Is like shrink-wrap for the 
components; It uses the full prefen-ed size of the 
center component then detemiines the size of the 
frame using the center as a starting point building 
the rest based on whaf s in the other regions. 

■ FlowLayout places components left to right top to 
bottom, In the order they were added, wrapping to a 
new line of components only when the components 
won't fit horizontally. 

■ RowLayout gives components their preferred size in 
both dimensions. 

■ BoxLayout lets you align components stacked 
vertically, even If they could fit side-by-side. Like 
FlowLayout^ BoxLayout uses the prefen^d size of 
the component in both dimensions. 

■ Borderi-ayoui is the default layout manager for a 
frame; FlowLayout Is the default for a panel. 

■ If you virant a panel to use something other than flow, 
you have to call set:Layout() on the panel 
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Playing with Swing components 

You've learned the basics of layout managers, so now let's try out a 
few of the most common components: a text field, scrolling text area, 
checkbox, and Hsl We won't show you the whole dam API for each of 
these, just a few highlights to get you started. 



JTextFleid 



e e d 



JTTaxtField field = n«w JText:Fi«ld(20) ; \j-ik.<^^''^' 



Constructors 



JTaxtrield field = now JTr«xtFiald("Your naaae^) 



How to use It 

0 Set text out of it 

System, out.pr in tin (field. gotTftxtO ) ; 

# Put text in it 

field . aetText ( ^^whatever" ) ; 
field.setText(^^;;)^ 



Set on ActionEvent when the user ^^J-^r. alio 
presses return or enter ^ 



field. addActionLlstaner (nyActlonListenor) ; 

ScJect/Highlfght the text in the field 
field. aelectAll () ; 

Put the cursor back in the field (so the user 
can just start typing) 

field . requestFocus ( ) ; 
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text area 

JTextArea 



Unlike JTextFicid, JTextArea can Kovc more than one line of text. It 
takes a little configuration to make one, because it doesn't come oat of 
the box with scroll bars or line wrapping. To make a JTextAreo scroll, you 
have to stick it in a ScrollPane. A ScrollPone is an object that rcaify loves 
to scroll, and will take care of the text orecls scrolling needs. , . , 



Construetor 

JTaxtAr«a taxt ^ naw JT«xtArM(10,20) ; 



How to use It 

# Make ft have a vertical scrollbar only ^ a^ta ^""^ 

JSorollPan* acxoll«zr > n»w JScrollPana (tAxt) ; Tell UiraW p^nt 

taxt.«etLin«Wrap(tru.) ; ^ j.^ ^^^^^ ^ 3 ^^^rij^^/ ^^^^^ 

flcxollor . BOtV«rticAlScrollBarPolicy (acrollPanoConatants , VERTICAL_Sa^LimR_ALMAYS) \ 
Bcrollar . 8«tHorizontalScrollBarPolicy (ScrollPanaConBtants . HORIZ<»JTAL_SCROH»BAR_NEVER) ; 



Replace the text thaf s in it 

1:*xt. BAtTttxt (''Not all who ar« lo«t ar» wandaring") ; 



Append to the text thaf s in it 
taxt. append (^^button clioJcad") 



Select/Highlight the text in the field 
taxt.a«lsctAll{) ; 



0 Put the cursor back in the field (so the user 
can just start typing) 

t«xt. r^quaatFocua () ; 
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JTextArea example 



in^rt javax. swing. *; 
in^^ort java.awt.*; 
Import java.awt. event. 



public class TextAraal Implements ActionLlstaner { 
JTextArea text; 

public static void main (String [] args) { 
TextAreal gui ^ new TextAreal(); 
gui.goO ; 

} 



twtton cUcieed 
button clicked 
button clicked 



public void go 0 { 

JFrame frame ■ new JFrame ( ) ; 
JPanel panel = new JPanel 0 / 

JButton button = new JButton Just Click It"); 
button, addAc tionLi 8 tener (this) ; 
text = new JTextArea (10 ,20) ; 
text. setLineWrap (true) ; 

JScrollPane scroller = new JScrollPane (text) ; 

scroller . setVerticalScrollBarPolicy (ScrollPaneConstants .VERTICAL_SCBOLLHAR_ALWAYS) ; 
scroller . aetflorizontalScrollBarPolicy (ScrollPaneConstants . HORIZONTAL_SCROIiIAAR_NEVER) 

panel. add (scroller) ; 

frame,getContentPane 0 , add ( Border Lay out. CENTER, panel) ; 
frame . getContentPana ( ) . add (BorderLayout , SOUTH , button) ; 

fraine.setflize(350,300) ; 
frame . setvisible (true) ; 



public void actionParformed (ActionEvent ov) { 
text, append ('"but ton clicked \n ") ; 



» tltowfhutton elm 



(III 



<ttd 




<:Urfcn*virt»i ^^t^j 
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check box 



JCheckBox 




Constructor 

JCheckBox check = new JCheckBox Goes to 11"); 

How to use It 

^ Listen for on item event (when if s selected or deselected) 
check. addltemListener (this) ; 



^ Handle the event (and find out whether or not it's selected) 

public void itemStateChanged(It«mEvent ev) { 
String onOrOff = ^^off"; 
if (check. isSelectedO ) onOrOff = "on'^; 
System- out. prin tin (''Check box is '' + onOrOf f ) ; 



^ Select or deselect it in code 

check. setSelec ted (true) ; 
check. setSelected (false) ; 



Aren't the layout manag- 
ers just more trouble than they're 
worth? If I have to go to all this 
trouble, I might as well just hard- 
code the size and coordinates for 
where everything should go. 

Getting the exact layout 
you want from a layout man- 
ager can be a challenge. But think 
about what the layout manager 
Is really doing for you. Even the 
seemingly simple task of figuring 
out where things should go on 
the screen can be complex. For 
example, the layout manager takes 
care of keeping your components 
from overlapping one another. 
In other words, it knows how to 
manage the spacing between 
components (and between the 
edge of the frame). Sure you can 
do that yourself, but what happens 
if you want components to be 
very tightly packed? You might get 
them placed just right by hand, 
but that's only good for your JVM! 

Why? Because the components 
can be slightly different from 
platform to platform, especially if 
they use the underlying platform's 
native look and fee!'. Subtle things 
like the bevel of the buttons can 
be different In such a way that 
components that line up neatly 
on one platform suddenly squish 
together on another 

And we're still not at the really Big 
Thing that layout managers do. 
Think about what happens when 
the user resizes the window! Or 
your GUI is dynamic, where com- 
ponents come and go. If you had 
to keep track of re-laying out all 
the components every time there's 
a change in the size or contents of 
a background component...yikes! 
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JList 







alpha" gl"" 




beta 




9 am ma j* [ 











Constructor 



String [] liatEntriea = (^^alpha", ^beta'^, ^^ganmiA", ^^daita" , 

"•pBilon", ^^zata", "Ota", '^thota ; 



llflt = new JLiat (listEntrioa) ; 



# Make ft have a vertical scrollbar J£tyrortP3^« fj" \. to ^« 

JScrollPan^ scroller * new J3croIlPane<list) ; 

scroller . Be tVerhicalScrollBarPolicy (ScrollPaneConstanta . VERTICAL_SCROLLBAR_ALWAYS) ; 
scroller. setHorixontalScrollBarPolicy (ScrollPaneConstants . HORIZ0fm:AL_SCROLLH^ 

panel , add (scroller) ; 
0 Set the number of Irnes to show before scrolling 

list.setVialbleRoiiCoiint(4) ; 



Restrict the user to selecting only ONE thing at a time 

list . setSelectionModa (Lis tSeleotionModel . SINGLE_SELECTiaM) ; 

Register for list selection events 

list, addListSelectionT.istener (this) ; u 

y^'«yt t^.eev«.i TWICE -^^/-d-t 

Handle events (f5nd out which thmg rn the list was selected) ^'^ 

public void valueChanged (ListSelectionEvent Ise) ( 

if( ! Ise. getValuelsAdjus ting 0 ) ( ^ n, 

String selection = (String) list . getSelectedValue () ; i^clc6i^d[/A\utO ^tiu^iiyj 
System.out.println(seleotion) ; ^. 7 

) I- -i J J J"^ ^ ''^ t 
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Code Kitchen 



Code Kitcken 



^.Dmm,. □□□□□□flaQQDgOaeQ ( start ) 

^«t: Hi-WM Q O i QO □ D □ O G D O a gO Q# stop S 

Open Hi-Hat -sBesBd □ □ (3 oo Q QQ □/ rr^r V 

Acoustk snare QQ Q Q Q QC G □ □ □ Q O >===i^ 

OashXYfifbal,. □Q-g HO O.QQ fi^O O □ □ □ □ Jzl^f!^.- 

Mantfoapt QGaGGDaoDDaaGGGn -fef.^^--. 
HighTom,,. aQDodGQadaaaaaGQ ^i^z^ s ^-^ 

Maracas □ □ □ □ Q G 0 S GQGG Q G O O ■ "fe-^^Z'^ -'^ 

wwstte oGGaGGdaoGOO.adGa 

Jt!m<:pjm^. aaaQdGaaGdGQQGQG 

Low-mid Twn' O QQ DdOG O G G G Q G G i O ' ■- " '''' 
-High Agoflo .Q-g Q G G G SG G G G •:, - ■■ ^- 



Tkis part s optional TVe^re making tke full BeatBox, GUI 
anct all In tke Saving OLjects ckapter, well learn kow to 
save and restore dniin patterns. Finally, in tke networking 
ckapter (Make a Connection), we'll turn tke BeatBox into a 
working ckat client. 
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Making the l^eail^ox 

This is the full code listing for this version of the BeatBox, with buttons for starting, 
stopping, and changing the tempo. The code hsting is complete, and fully- 
annotated, but here's the overview: 



Build a GUI that has 256 checkboxes (JCheckBox) that start out 
unchecked, 16 labels (JLabel) for the instrument names, and four 
buttons. 

Register an ActionListener for each of the four buttons. We don't 
need listeners for the individual checkboxes, because we aren't 
trying to change the pattern sound dynamically (i.e. as soon as the 
user checks a box). Instead, we wait until the user hits the 'start' 
button, and then walk through all 256 checkboxes to get their state 
and make a MIDI track. 

Set-up the Mlbl system (you've done this before) including getting 
a Sequencer, making a Sequence, and creating a track. We are using 
a sequencer method that's new to Java 5.0, setLoopCount( ). This 
method allows you to specify how many times you want a sequence 
to loop. We're also using the sequence's tempo factor to adjust the 
tempo up or down, and maintain the new tempo from one iteration of 
the loop to the next. 



When the user hits *start', the real action begins. The event-handling 
method for the 'start' button calls the buildTrackAndStart() method. 
In that method, we walk through all 256 checkboxes (one row at 
a time, a single instrument across oil 16 beats) to get their state, 
then use the information to build a MIDI track (using the handy 
makeEventO method we used in the previous chapter). Once the track 
is built, we start the sequencer, which keeps playing (because we're 
looping it) until the user hits 'stop'. 
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BeatBox code 



insert java.anl:.*; 
in^ort javax, awing. * ; 
import javax. soimd.midi . * ; 
Lraport jAva.util.*; 
import java. awt. event .* ; 



public clasa BeatBox { 



^nrdy, buildmg i\,c labels U tath vow) 



JPanel mainPanel; 

ArrayList<JCh©ckBox> chackboxLiflt; 
Sequencer sequencer; 
Sequence sequence; 
Track track; 
JTraxtte tlxeFraioe; 

the <^U/ labels (oh c^dh vow) 
String [] inatrumentKamea = ('"Bass Drum", "Closed Hi-Haf^ 

''Open Hi-Hat" , ^Acoustic Snare", ''Crash Cymbal", ^'Hand Clap", 
"High Tom", '^Hi Bongo", ^^Maracas", ^Whistle", "Low Conga", 
'^Cowbell", "Vibraslap", ^Low-mid Tom", '^High Agogo", 
"Open Hi Conga"); 

int[) instruments = (35,42,46,38,49,39,50,60,70,72.64,56,56,47,67,153); 



public static void main (String [] args) ( 
new BeatBox2() ,buildGDI() ; 



^t^rcstni {he atiual dru^ W'. 
T>»c drun^ dK^^inel h like a p*a>.o, c^oi 

o. iW, p;a.o is a d^^Mdr.^ 

dru^, H h Qostd Ri-Kat tit. 

pxiblic void buildGOTO ( 

theFrame = new JFrame ("Cyber BeatBox"); 

theFrame . setDef aultCloseOperation ( JFrame, EXIT_ON_CIiOSE) ; 
BorderLayout layout = new Borderl^yout () ; 
JPanel background = new JPanel (layout) ; 

background. setBorder (BordarFactory . createEmptyBorder (10,10,10,10)) ; 



checkboxList = new ArrayList<JChec3cBox> () ; 
Box buttonBox = new Box (BoxLayout . Y_AXIS) ; 

JButton start = new JButton ("Start^') ; 

start. addActionliistener (new MyStartListener () ) ; 

buttonBox, add (start) ; 

JButton stop = new JButton ("Stop") ; 

stop . addActionLifitener (new MyStopListanar () ) ; 

buttonBox. add (stop) ; 

JButton upTempo = new JButton ("Ten^x? Dp"); 
upTempo .addActionliistener (new MfyUpTempoListener () ) 
buttonBox . add (upTen^o) ; 

JButton downTempo = new JButton ("Tempo Down"); 
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downTeispo . addActionListenar (new MyDomTenipoListener ( ] ) ; 
but,tonBox.add(downTaiopc) ; 



Box namaBox - ne*r Box(BoxLayout.Y_AXIS) ; 
for (int i = 0; i < 16; i-H-) ( 

namaBox. add (new Label (InstxunifiLntMainas [i] )) ; 

} 

background. add (BorderLayout.ELAST, buttonBox) ; 
background. add (BorderLayout. WEST, namaBox) ; 

thsFraine . gatContentPana () . add (background) ; 

GridLayout grid = naw GridLayout(16y 16) ; 

grid. aatVgap (1) ; 

grid.setHgap(2) ; 

malfiPanal = new JPanal (grid) ; 

backgroxmd. add (BordarLayout. CENTER, mainPanal) ; 



Kati>m5 remarkable- 



for (int i = 0; i < 256; i++) { 

jCheckBox c = naw JChackBox ( ) ; 

c . satSalactad (false) ; 

chackboxList. add(c) ; 

mainPanal . add(c) ; 
) // and loop 

satUpMidiO ; 



thaFraiae . satBounds (50 , 50 , 300 , 300) ; 
thaFrama . pack ( ) ; 
thaFrama . aatVisible (true) ; 
) // close xMthod 



public void 

^a^encer ^ MidiSystem.getSaquancer () ; / I^^^^l/^'P^ ^'"'P 

eecCaancar,opan() ; f Ind iJ^ T jf^T^' 

aaquance = now Sequence (Saquanca,PPQ, 4) ; j ^ i /tJJm, r>o^i>vj ipi^ij|. 

track = sequence . craateTrack <) ; 
sequencer .aatTaxnpoInBPM (120) ; 

} catch (Exception a) {e .printStackTrace () ; } 
} // cloaa mathod 



you are here ► 421 



BeatBox code 



int[l trackList = null; ^ ^J" ^LUat ' "^"^ '"'^'^ ^ 



public void JfeiilJv^^H^^ { 



sequence .deleteTrack( track) ; 
track = sequence . createTrack ( ) ; 



. r J +We Ifc ROWS (\ t- Ba«. C*^"' 

for (int i = 0; i < 16; { < ' do t><« '^^^ *^ **** ' 

trackList = new int [16] ; 

int lcey= instruments [i]; "^^grMlfe '^^^^^^ 

for (int j = 0; j < 16; j++ ) { p, ^W.s ^or ca6>. iV,e BtATS U iW.s <ro>. 

JCheckBox jc = (JCheckBox) checkboxList.get ( j + (16*i)); 

if ( jc.isSelectedO ) { ^ 

trackList [j] = key; / . , , . » » * ,o ir i 

J else { > Is tKe dKetkbovc al iKis beai sclcttcd? 1+ Y«^' P^^ 

trackList [j] =0; \ ^Kc key valt^ in this s!oi m the array dht s\ci tKat 

} ' ) rcfrcscn-b ibis bcai). Ot^terwtsc, tSc ms-trumcn-t is 

} // close inner loop ^ I^OT supposed io flay at iHis beat s«> ^ei it to 2^ro. 

makeTracks (trackList) ; " 4^Wis \nstrv^ent> and ^or all 1^ beats, 

track.add{inakeEvent(176,l,127,0,16)) ; ^^j^g ^c^^m; a^d add tbew to tKc tratK- 



> // close outer 



track . add (makeEvent (192 , 9 , 1 , 0 , 15) ) ; 



V^e aUays ^a«t to n^ake sure that tberc IS a>r» event ai 
beat fit ^ocs 0 to 1^). Otherwise, tKc t>eatt>o^ mijht 



try { ^V>e +UI beats before it starts over, 

sequencer . se tSequence ( sequence ) ; 

sequencer. setLoopCount( sequencer. LOOPjCONTINUOUSLY) ; ^ Lets you speii-fy number 
sequencer. s tart 0 ; joof itcratioirvs, or in {!hss 

sequencer. setTerapoInBPM (120) ; "\ ^^^^^ Continuous looping. 

} catch (Exception e) {e.printStackTrace () ; } J 
) II close buildTrackAndStart method ) 

^OWFLAYTHBTm^a 

public class M^tiltZtl^Btmwx in^lements ActionListener { -s. 
public void actionPerf ontied (ActionEvent a) { ) 

buildTrackAndStart 0; V ihe m.ev- da«es, 

} // close inner class J Hothm^ sp^iaj hev«. 
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public class ppH^^p^^Hp^inqpleinents ActionListener { 
public void actionPerf onoed (ActionEvent a) { 
sequencer . stop ( ) ; 

} 

} // close inner class 

public class ^ ^^^^ ^j0^1^^^0±sapleaiBnts ActionListener { 
public void actionPerf ormed (ActionEvent a) { 

float tenpoFactor = sequencer .getTempoFactor () ; 
sequencer,setTenipoFactor( (float) (terapoFactor * 1,03)); 

) 

} // close inner class 

public class ^il^0isi0^^f^jl0^^^^^l^^^ implements ActionListener ( 
public void actionPerformed (ActionEvent a) { 
float terapoFactor = sequencer. getTea5>oFactor () ; 
sequencer . setTen5>oFactor ( (float) (terapoFactor * . 97) ) ; 

} 

} // close inner class 



The Tempo Fatior stales 
I ihc $c«\ucndcv's iewfo by 
' -the -faetor f^rovided. TKc 
de-fauii is j.O, so were 
adjusi'mj +/- "5% per 



public void 



(int[] list) { 



for (int i = 0; i < 16; i++) { 
int key = list[i] ; 



all It So ^"^^^'^"'t-'^til told e.t^- 
key ^^-f ^ pUv ai iKat beat 



0-{^cr>/»sei make an even- 



if (key != 0) { 

track . add (laakeEven t (144,9, key , 100 
track . add (makeEven t (128,9, key , 100 

} 



' ^ MakelheKOTtON and 

, i+i) ) ; ) j^^-p ^pp evew-b, and 
add tHem iKe Tratk- 



} 



public MidiEvent ^^i||^|^|^(int comd, int chan, int one, int two, int tick) { 
MidiEven t event = null ; 
try { 

ShortMessage a = new ShortMessage () ; 
a.setBtessage(conid, chan, one, two); y,. 

event « new MidiEvent(a, tick) ; i<iiHy ^^iW 4 



} catch (Exception e) {e.printStackTrace () ; } 
return event; 



} // close class 
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exercise: Which Layout? 

\jk.ek code goes widi 
yAa.ck layout? 

Five of the sfx screens below were made from one 
of the code fragments on tha opposite page, Match 
each of the five code fragments with the layout that 
fragment would produce. 
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using swing 



OJFrame frame ~ new JFrame ( ) ; 
JPanel panel = new JPanel ( ) ; 
panel . setBackground (Color . darkGray) ; 
JButton button = new JButtonC'tesuji") ; 
JButton buttonTwo = new JButton ("watari") ; 
frame . getContentPane ( ) . add (BorderLayout. NORTH, panel) ; 
panel . add (buttonTwo) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER, but ton) ; 



^ JFrame frame = new JFrame () ; 
3 JPanel pwel ^ new JPanel () ; 

panel . setBackgroiind (Color . darkGray) ; 

JButton button = new JButton (^^tesuji") ; 

JButton buttonTwo « new JButton ('^watari") ; 

panel . add (buttonTwo) ; 

frame . getContentPane ( ) .add (BorderLayout. CENTER, button) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel) ; 



JFreuae frame = new JFrame ( ) ; 

JPanel panel = new JPanel ( ) ; 

peinel . setBackground (Color . darkGray) ; 

JButton button = new JButton ( '^tesuj i" ) ; 

JButton buttonTwo = new JButton ("Vatari") ; 

panel . add (buttonTwo) ; 

frame . getContentPane ( ) .add (BorderLayout. CENTER, button) ; 



^ JFrame frame = new JFrame (); 
JPanel panel = new JPanel ( ) ; 
panel . setBackground (Color . darkGray) ; 
JButton button = new JButton ('"tesuji") ; 
JButton buttonTwo = new JButton ("watari") ; 
panel. add (button) ; 

frame . getContentPane ( ) . add (BorderLayout . NORTH ^buttonTwo) ; 
frame . getContentPane ( ) . add (BorderLayout . EAST , panel) ; 



©JFrame frame = new JFrame ( ) ; 
JPanel parnel = new JPanel ( ) ; 
panel . setBackgroxind (Color . darkGray) ; 
JButton button = new JButton ( ^^tesuj i" ) ; 
JButton buttonTwo ~ new JButton ( '"watari" ) ; 
frame.getContentPaneO .add (BorderLayout. SOUTH, panel) ; 
panel . add (buttonTwo) ; 

frame.getContentPaneO .add (BorderLayout. NORTH, button) ; 
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puzzle: crossword 




(MrOvm 7.0 




You can do It 



Across 

I. Artisfs sandbox 

4. Border's catchall 

5, Java look 

9. Generic waiter 

II. A happening 
12. Apply a widget 

15. JPaners default 

16. Polymorphic test 



17. Shake It baby 
21. Lots to say 
23. Choose nnany 

25. Button's pal 

26. Home of 
action Performed 



Down 

Z Swing's dad 
3. Frame's purview 

5. Help's home 

6. Morefun than text 

7. Component siang 

8. Romulin command 

9. Arrange 

10. Border's top 



13. Manager's rules 

14. Source's behavior 

15. Border bydefiault 

18. User's behavior 

19. loner's squeeze 

20. Backstage widget 
22, Mac look 

24. Border's right 
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OJFrame frame ~ new JFramd () ; 
JPanel panel c new JFanel () ; 
panel . setBacXground (Color . daxIcGray) ; 
JButton button = new JButton ("teauji'') ; 
JButton buttonTwo = new JButton ("wataxi'') ; 
panel . add (buttonTwo) ; 

frame. getCoDt«ntPane() . add (BorderLayout. CENTER, button) ; 



OJTraoe frame - new JFrameO; 
JPanel panel = new JPanelO; 
panel. aetBaoJtground (Color. darkGray) ; 
OTButton button = new JButton (^'teaujl") ; 
JButton buttonTwo - new JButton (^^watajci") ; 
frame. getConteJitPaneO . add (BorderLayout. NORTH, pAnel) ; 
panel . add (buttonTwo) ; 

frame .getContentPane 0 .add (Border Lay out. CENTER, but ton) ; 



©JTrame frame new JFrame ( ) ; 
JTanel penel = new JPanel (); 
panel . setBackgxound (Color . darkGray) ; 
JButton button = new JButton (^^teauji" ) ; 
JButton buttonTwo = new JButton (""watari'') ; 
frarne. getContentPane 0 . add (BorderLayout. SOUTH, panel) ; 
panel . add (buttonTwo) ; 

frame.getContentPane {) , add (BorderLayout. NORTH, button) ; 



OJFrame frame = new JFrame () ; 
JPanel panel = new JPanelO; 
panel . setBackground (Color . daxkGray) ; 
JButton button = new JButton C'teauji") ; 
JButton buttonTwo = new JButton ("watari") ; 
panel . add (button) ; 

frame. gatContejitPaneO .add (BorderLayout. NORTH, buttonTwo) ; 
frame . getContentPane 0 .add (BorderLayout.£AST, panel) ; 



OJFrame frame = new JFrameO ; 
JPanel panel n new JPanelO ; 
panel . aetBackground (Color . daxkGray) ; 
JButton button = new JButton (^'tesuji") ; 
JButton buttonTwo a new JButton {^'watAri'') ; 
panel . add (buttonTwo) ; 

frame. getContentPane 0 . add (BorderLayout. CENTER, button) ; 
frame . getContentPane 0 . add (BorderLayout .EA5T, panel); 
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fnzz[t Answers 




'DRAW PA NE L 



1 4 serialization and file I/O 



Saving Objects 




If I have to read 
one more file full of 
datQ, I think Til have to kill him. He 
knows 1 can 5ave whole objects, but 
does he let me? NO, that would be 
^ too easy. Well, we'll just see how 
he feels after I... 



Objects can be flattened and inflated, objects have state and behavior. 
Behavior \\yjes In the class, bijX state lives within each individual object^So what happens when 
it's time to save the state of an object? If you're writing a ganr^e, you're gonna need a Save/ 
Restore Game feature. If you're writing an app that creates charts, you're gonna need a Save/ 
Open File feature. If your program needs to save state, you can do It the hoz-d vv^oy, interrogating 
each object, then painstakingly writing the value of each instance variable to a file, In a 
format you create. Or, you can do It the easy 00 way— you simply freeze-dry/flatt en /persist/ 
dehydrate the object itself, and reconstltute/lnflate/resiore/rehydrate It to get it back. 8ut you'll 
still have to do it the hard way somer/mes, especially when the file your app saves has to be read 
by some other non-Java application, so we'll look at both In this chapter. 
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saving objects 



Capture the Peat 



YouVe made the perfect pattern. You want to 501/5 the pattern. 
You could grab a piece of paper and stan scribbling it down, but 
instead you hit the Saz/e button (or choose Save from the File 
menu). Then you give it a name, pick a directory, 
and exhale knowing that your naasterpiece won't go 
out die window with the blue screen of death. 

You have lots of options for how to save the state of 
your Java program, and what you choose wiU probably 
depend on how you plan to use the saved state. Here 
are the opdons we'D be looking at in this chapter. 

If your data will be used by only the Java 
program that generated It: 

# Use seriQlrzatiOii 

Write 0 file that holds flattened (serialised) 
objects. Then have your program read the 
serialized objects from the file and mflote them 
back into living, breathing, heap-inhabiting objects. 




If your data will be used by other programs: 

@ Write a ploin text file 

Write Q file, with delimiters that other programs can parse. 
For example, a tab-delimited file that a spreadsheet or 
datobose application can use. 



These aren^t the only options, of course. You can save data in any 
format you choose. Instead of wriung characters, for example, 
you can write your data as bytes. Or you can write out any kind 
of Java prinr^idve a Java primiuve — there are methods to write 
ints, longs, booleans, etc. But regardJess of the method you use, 
the fundamental I/O tecKniques are pretty much the same; 
write some dau to sonuthing, and usually d^ai something is either 
a file on disk or a stream coming from a nenvork connection, 
Reading die data is the same process in reverse: read some data 
frorri either a file on disk or a network connecrion. And of course 
everything we talk about in this part is for rimes when you aren^t 
using an actual database. 
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Saving State 



Imagine you have a program, say, a famtasy 
adventure game, that takes more than one 
session to complete. As the game progresses, 
characters in the game become stronger, weaker, 
smarter, etc, and gather and use {and lose) 
weapons. You don't want to start from scratch 
each time you launch the game — it took you 
forever to get your characters in top shape for 
a spectacular batde. So, you need a way to save 
the state of the characters, and a way to restore 
the state when you resume the game. And since 
you're also the game programmer, you want the 
whole save and restore thing to be as easy (and 
foolproof) as possible. 



Option one 

Write the three serfolized 
character objects to a file 

Create a file and write three serrolixed 
character objects. The file won't make 
sense if you try to read it as text: 

'jbnrOamdOharaotar 
~%j6dnir&Xyowe3^ava/laxi^ 
String; [woftponst [Zttava/Un^ 

Are JiMnOaVbig MWi^xtMatfoiaTHUL^'tap^ 
llxtln visibility 



Option two 

Write a plain text file 

Create o file and write three lines of text, 
one per character, separating the pieces 
of stote with commas: 

80^JBlf,baOT^ mordf dust 
ftOO^Troll^bara hands^bij ax 
lgO,Matfniftii,gpftmi,iiivistMlity 



GameCharactfir 



(nt power 
String type 
WeaponQ weapons 



getWeaponO 
useWeaponO 
lncreasePower() 
//nr>ore 



l^agint you 

ir ^^-^ 

fi^aracter. to save... 
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Writing a serialized object to a file 

Here are the steps for serializing (saving) an object Don*t bother 
memorizing aD this; well go into more detail later in this chapter 



Make a FlleOutputStrec in ^ 

FileOutputStream fileStream = new FileOutputStream("MyGanie . ser'') ; 



Moke an ObjcctOutputStream 

ObjectOutputStream os = new ObjectOutputStrGam(fileStream) ; 

tailed or^rtjrea-^ 



Q Wr;lt_e the object ^ ,{eren«a W i^^^^^' 

o3 .writeObject (characterona) ; t'S?.at /"^t J^^^^^;!'^^:^^^ 
OS . writeObject (characterTwo) ; ti^ ^ ^< '^'^^ 



4 — >^ w..- 
os.writoQbject (characterThrea) ; itr^ 



C[ose the ObjectOutputStreom 

OS . close ( ) )^ ^ 

C)«i»»g the ^ 
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Pata moves \n streams from one place to another 




CoMiiectioH 
streams represent 
a cohnectloH 
to a source or 
destination (flk 
socket etc.) while 
chain streams 
can't connect on 
their own and must 
be chained to a 
connection stream. 



The Java I/O API has connection streams, that represent connections to destinations and 
sources such as files or network sockets, and dhain streams that work only If chained to 
other streams. 

Often, it takes at least two streams hooked together to do something usejpu] — one to 
represent the connection and another \o call methods on. Why two? Because connection 
streams are usually too low-level. FileOutputStream (a connection stream), for example, 
has methods for writing bytes. Bvu we don't want to write byUs\ We want to write ol^ecis, so 
we need a higher-level chain stream. 

OK, then why not have jiista single stream that does exactly vih-BX you want? One that lets 
you write objects but undemeatli converts Uiem to bytes? Think good OO. Each class 
does 07?^ tiling well. FiJcOurputStreams write bytes to a file. ObjectOutputStreams turn 
objects into data that can be written to a stream. So we make a FileOutputStream that lets 
us write to a file, and we hook an ObjectOutputStream (a chain stream) on the end of it. 
When we call writeObject() on the ObjectOutputStream, the object gets pumped into the 
stream and then moves to the FileOutputStream where it ultimately gets written as bytes 
to a file. 

The ability to mix and match different combinations of connection and chain streams 
gives you tremendous flexibility! If you were forced to use only a single %\jfm\ class^ you'd 
be at the mercy of the API designers, hoping they'd thought of euerythingyou might ever 
want to do. But with chaining, you can patch together your own custom chains. 



is written to 



object is flattened {tznaWztd) 



object is written as bytes to 



ject 



is chained to 



011010010110111001 



ObjectOutputStre^am 
(a choin stream) 



FilcOutputStreom 
(a connection streom) 




RIe 
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What really happens to an object 
whew it's serialized? 



Q Object on the heap 



^ Object serialized 





Objects on the heap have state—the 
value of the object's instance 
variables. These values make one 
instance of a class different from 
another instance of the same doss. 




Foo myFoo = new Foo ( ) 
myFoo.86tWidth(37) ; 
myFoo. aatHeight (70) ; 



Serialized objects save the values 
of the instance variables, so that 
an identical instance (object) can be 
brought back to Jif e on the heap. 



width 
aau iyyc is). 

FileOutputStream fa = new FileOutputStxeamC'foo-aer") 
ObjectOutputStream os ^ new ObjactOutputStraam(fs) ; 
OS. writaObject (myFoo) ; 

%itOu^p.tSWio^i^ ih* object 
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l^ut what exactly jS an object's state? 
What needs to be saved? 



Now it starts to get interesting. Easy enough to save the primitive 
values 37 and 70. But what if an object has an instance variable 
that*s an object refermc^ What about an object that has five 
instance variables that are object references? What if those object 
instance variables themselves have instance variables? 

Think about iL What part of an object is potentially imique? 
Imagine what needs to be restored in order to get an object that's 
identical to the one that was saved. It will have a different memory 
location, of course, but we don't care about thaL All we care about 
is that out there on the heap, we'll get an object that has the same 
state the object had when it was saved. 




Brain Barbell 



What has to happen for the Car 
object to be saved in such a way 
that It can be restored back to its 
original state? 



The Car object has two 
instance variables that 
reference two other 
objects. 




Think of what — and how— you 
might need to save the Car 



And what happens rf an Engine 
object has a reference to a 
Carburator? And what's inside the 
TireD array object? 



What does It take to 
save a Car object? 
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When an object is serialized, all the objects 
it refers to from Instance variables are also 
serialized. And all the objects those objects 
refer to are serialized. And all the objects those 
objects refer to are serialized... and the best 
part is, it happens automatically! 

This Kennel object has a reference to o bog [] arroy object. The 
Dog [] holds references to two bog objects. Each bog object holds 
Q reference to a String and o CoUor object. The String objects 
hove Q collection of chorocters and the Cot/or objects have an int. 

When you save the Kennel, oH of thfs is SQvedl 



Serialization saves tke 
entire oLject grapk 
All otjects re^erenceet 
hy instance variattes, 
startingf witk tlie 
oLject l>ein^ serializecL 
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If you want your class t o be serialtzabic, 
implement I 



Serializable 



The Serializable interface is known as a marker or interface, 
because the interface doesn't have any methods to implement. Its 
sole purpose is to announce that the class implementing it is, well, 
serializable. In other words, objects of that type are saveable through 
the serialization mechanism. If any superclass of a class is serializable, 
the subclass is automatically serializable even if the subclass doesn't 
explicitly declare implements Serializable, (This is how interfaces always 
work. If your superclass "IS-A" Serializable, you are too). 



objectOutputStream, writeObject (myBox) ; 



Ser' 



r 

Kb S«r1»HMhl« / ,^„|cmcn.^ , 



import java.io.*; ^ ..ted tVe "^'^Y*^' , . . „U«,e».t. >'^<'* Y*^ 

public class Box inyl ^nts Serializable { ^^^olcwicn-b Scv-*»aliwic , J ^ „ 



private int width; i 
private int height/ these two values will he 



public void setWidth(int w) { 
width » w; 

} 

ptiblic void setHeight (int h) { 
height = h; 

) 

public static void main (String [] args) { 



myBox. setWidth (50); ' , ^ ^rt'^w^'i , 



BOX myBox - new Box() ; to a ^-^f .^^ ,a\te a 




try { 

FlleOutputStxeam fs a new FileOutputStream("foo.ser") ; 
ObjsctOutputStreaffl os s new ObjectOutputStream (fs) ; 

08.writeObjeot(ayBox) ; A: J*> i?bi./i/i j , 

os.closeO ; \ <^^i.cd Ut ^^'^^''^^^.^ 

) catch (Exception ex) { '^*""^«^ioh 4^^.^, 

ex.printStacMraceO ; '^'I 'liic^ i /■ 

J '« the <,|,jg^^ 

} 
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Serialization is all or nothing. 



Can you imagine what would 
happen if some of the object's 
state didn't save correctly? 



Eeew/ww! That 
creeps me out just thinking 
about iti Like, what if a Dog comes 
back with no weight. Or no ears. Or 
the collar comes back size 3 instead 
of 30. That just con t be ollowed! 



import java.io.*; 



tantc 



public class Pond inplements Sdrializable { 

private Duck duck = new E>uck<); ^ — ^^^^^^^^^ T^^ /V 

public static void main (String [] args) ( 
Pond myPond = naw Pond ( ) ; 
try { 

FileOutputStraam fs = new FileOutput5tream{^^Pond. ser") ; 
Ob joctOutput Stream os = new ObjeotOutputStream (f a) ; 



OS . writeObjact (myPond) . 
oa . close () ; 

) catch (Exception ax) { 
ox.printStackTrace 0 ; 

) 



Either the entire 
object graph is 
serialized correctly 
or serialization fails. 

You can't serialize 
a Pond object if 
its Ducic instance 
variable refuses to 
be serialized (by 
not implementing 
Serializabie). 





public class Duck { 
// duck code here 

} 



/ifea'/ Duik Is not icri^Uz^hlcl 
ft imdfmcnt ^\3\iZ3\>\e, 

so Nvh<^^ you {^.y icri^liz^ a 
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If s hopelesSi 
then? Tm completely 
screwed if the idiot who 
wrote the class for my instance 
variable forgot to make it 
^ V Senalizabic? 



Mark an Instance variable as transjent 
If it cari't (or shouldn't) be saved. 

If you want an instance variable to be skipped by the 
serialization process, mark the variable with the transient 
keyword. 



save "'i^ t iV^*? 



t>t lived a, 
the chxeci't 



4wiport java.nat.*; 

class Chat inplaments Ssrlalizable 

^ transient String currentID; 



String userName ; 



// more code 



If you have an instance variable that can'i be saved because 
it isn't serializable, you can mark that variable with the 
transient keyword and the serialization process will skip right 
over it 

So why would a variable not be serializable? It could be 
that the class designer simply forgot to make the class 
implement Serializable. Or it might be because the object 
relies on runtime-specific infonmation that simply can*t be 
saved. Although most things in the Java class libraries are 
serializable, you can*t save things like network connections, 
threads, or file objects. They're all dependent on (and 
specific to) a particular rundme 'experience'. In other words, 
they're instantiated in a way that s unique to a particular run 
of your program, on a particular platform, in a particular 
JVM. Once the program shuts down, there's no way to bring 
those things back to life in any meaningful way^ they have to 
be created from scratch each time. 
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Dumb Questipns 

If serialization is so important, 
wliy isn't it the default for all classes? 
Why doesn't class Object implement 
Serializable,and then all subclasses 
will be automatically Serializable. 

Even though most classes will, 
and should, implement Serializable, 
you always have a choice. And you 
must make a conscious decision on 
a class-by-class basis, for each class 
you design, to 'enable' serialization 
by implementing Serializable. 
First of all, if serialization were the 
default, how would you turn it off? 
Interfaces indicate functionality, not 
a lack of functionality, so the model 
of polymorphism wouldn't work 
correctly if you had to say,"implements 
NonSerializable"to tell the world that 
you cannot be saved. 



Why would I ever write a class 
that wasn't serializable? 

There are very few reasons, but 
you might, for example, have a security 
issue where you don't want a password 
object stored. Or you might have an 
object that makes no sense to save, 
because its key instance variables are 
themselves not serializable, so there's 
no useful way for you to make your 
class serializable. 



If a class I'm using isn't 
serializable, but there's no good 
reason (except that the designer just 
forgot or was stupid), can I subclass 
the 'bad' class and make the subclass 
serializable? 



Yes! If the class itself is 
extendable (I.e. not final), you can 
make a serializable subclass, and just 
substitute the subclass everywhere 
your code is expecting the superclass 
type. (Remember, polymorphism 
allows this.) Which brings up another 
interesting issue: what does It mean if 
the superclass is not serializable? 

You brought it up: what does it 
mean to have a serializable subclass 
of a non-serializable superclass? 

First we have to look at what 
happens when a class is deserialized, 
(we'll talk about that on the next few 
pages). In a nutshell, when an object 
is deserialized and its superclass is not 
serializable, the superclass constructor 
will run just as though a new object of 
that type were being created. If there's 
no decent reason for a class to not 
be serializable, making a serializable 
subclass might be a good solution. 

Whoal I just realized 
something big... if you make a 
variable 'transient', this means the 
variable's value is skipped over 
during serialization.Then what 
happens to it? We solve the problem 
of having a non-seriallzable instance 
variable by making the instance 
variable transient, but don't we NEED 
that variable when the object is 
brought back to life? In other words, 
isn't the whole point of serialization 
to preserve an object's state? 

Yes, this Is an issue, but 
fortunately there's a solution. If you 
serialize an object, a transient reference 
instance variable will be brought back 



as null, regardless of the value it had 
at the time it was saved.That means 
the entire object graph connected to 
that particular Instance variable won't 
be saved.This could be bad, obviously, 
because you probably need a non-null 
value for that variable. 

You have two options: 

1) When the object is brought back, 
reinitialize that null instance variable 
back to some default state. This 
works if your deserialized object isn't 
dependent on a particular value for 
that transient variable. In other words, 
it might be important that the Dog 
have a Collar, but perhaps all Collar 
objects are the same so it doesn't 
matter if you give the resurrected Dog 
a brand new Collar; nobody will know 
the difference. 

2) If the value of the transient variable 
does matter (say, if the color and design 
of the transient Collar are unique for 
each Dog) then you need to save the 
key values of the Collar and use them 
when the Dog is brought back to 
essentially re-create a brand new Collar 
that's identical to the original. 

What happens if two objects in 
the object graph are the same object? 
Like, if you have two different Cat 
objects in the Kennel, but both Cats 
have a reference to the same Owner 
object* Does the Owner get saved 
twice? I'm hoping not. 

Excellent question! Serialization 
is smart enough to know when two 
objects in the graph are the same. In 
that case, only one of the objects is 
saved, and during deserialization, any 
references to that single object are 
restored. 
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Peaerialization: restoring aw object 

The whole point of senalizmg an object is so that you can 
restore it back to its original state at some later date, in a 
different 'run' of the JVM (which might not even be the same 
JVM that was running at the time the object was serialized) . 
Deserialization is a lot like serialization in reverse. 

0 Make o RjelnputStream ^ 

FilelnputStream fileStream = new FileInputStream(^'MyGainfi . aer") ; 



o 



Make an ObJcctlnputStream 

Ob ject Inputs tr earn os = new ObjectlnputStream(^eStream) ; 



read the objects 

Object one = os . readOb j ect ( ) ; Cafh time yo^ reAdO\>\ui(), vow aet 
Object two = OS . readObject ( ) ; fJJ*** ^e3,r. £o you'll rtld it,<m baek in 

Object three = os . readObject ( ) ; ^T'^ ff,"" ^J-'^*- i)ey we»-e writt<„. /oull 

^ Cost the objects 

GameCharacter elf — (GaneCharacter) one; vaW 

GameCharacter troll — (GameCharacter) two; ^'j^k^ 's 'ty?' ^^j*'^ 



GameCharacter magician = (GameCharacter) three; 



Close the ObJectlnputSlream 

OS . close ( ) ;^ ^ 

you are here f 441 
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What happens during deserialization? 

When an object is deseriaJized, the JVM attempts to bring 
the object back to life by making a new object on the heap 
that has the same state the serialized object had at the time it 
was serialized. Well, except for the transient variables, which 
come back either null (for object references) or as default 
primitive values. 



0\/M 



m 




01101001 
01101110 
01 



object is read as bytes 



class is found and loaded, saved 
instance variobles reassigned 



4k 



Is read by 



OllOlOOlOlIOlllOOl 



is chained to 





FilelnptitStraam 
(a connection stream) 



ObjectlnputStream 
(q charn 5treom) 



Object 



^ The object [5 read from the stream. 

^ The JVM determmes (through Info stored with 
the serialized object) the object's class type. 



^ The JVM attempts to find and load the ob- 
ject's doss. If the JVM con t find and/or load 
the class, the JVM throws an exception and 
the deserialization fails. 



Q A new object is given space on the heap, but 
the serialized object's constructor docs 
NOT run( Obviously, if the constructor ran, it 
would restore the state of the object back 
to its original 'new* state, and that's not what 
we want. We wont the object to be restored 
to the state it had when it was serialized, not 
when ft was first created. 
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^ If the object has a rton-serializable doss 
somewhere up its inheritance tree, the 
constructor for that non-seriolizable class 
will run along with any constructors above 
that (even if they're serial izable). Once the 
constructor chaining begins, you can't stop it, 
which means all superclasses, beginning with 
the first non-serializable one, will reinitialize 
their state. 

^ The object's instance variables are given the 
values from the serialized state. Transient 
variables are given a value of null for object 
references and defaults (0, false, etc.) for 
primitives. 



Dumb QuestiPns 

Why doesn't the class get saved as part of the obr 
ject? That way you don't have the problem with whether 
the class can be found. 

A- 

-M.* Sure, they could have made serialization work that 
way. But what a tremendous waste and overhead. And 
while It might not be such a hardship when you're using 
serialization to write objects to a file on a local hard drive, 
serialization is also used to send objects over a network 
connection. If a class was bundled with each serialized 
(shippable) object, bandwidth would become a much larger 
problem than it already is. 

For objects serialized to ship over a network, though, there 
actually is a mechanism where the serialized object can be 
'stamped' with a URL for where its class can be found. This 
is used In Java's Remote Method Invocation (RMl) so that 
you can send a serialized object as part of, say, a method 



argument, and if the JVM receiving the call doesn't have 
the class, It can use the URL to fetch the class from the 
network and load it, all automatically. (We'll talk about RMI 
in chapter 17.) 

What about static variables? Are they serialized? 

A- 

Nope. Remember, static means "one per class" not 
"one per object'^ Static variables are not saved, and when an 
object is deserialized, it will have whatever static variable 
its class currenf/y has, The moral: don't make serializable ob- 
jects dependent on a dynamically-changing static variable! 
It might not be the same when the object comes back. 
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Saving and restoring the qme characters 



iniport java.io.*; 



public class GaineSaverTest { 

public static void main{Stririg(] axgs) { 
GameCharacter one = new GamsCharacter (50, "Elf", new String{] {''bow''; ''sword"; ''dust''}); 
GamaCharactex two = new GaBeChaxacter(200; "Troll", new StxingO {"bare hands''; ''big ax"}); 
GameCharacter three = new GameCharacter (120, '"Magician"; new Stringf] (''spells"; ''invisibility"}); 

// ijnagine code that does things with the characters that laight change their state values 

try ( 

(a)3ectOutputStream os = new Ob]ect(5utputStream(new FileOutputStreamC'Game.ser'') ) ; 
os,writeObj6ct(one) ; 
03,write0bject(two) ; 
08, writeObj6ct( three) ; 

OS. closed / 
] catch (lOException ex) { 
ex.printStacJcTraceO ; 



one = null; 
two = null; ^ 
three = null; 

f^c^ rt^d tK«r« \>3tk In W (\\e... 

try { I 
ObjectlnputStreaa is - new ObjectInputStream(n6w FilelnputStreamC'Game.ser") ) ; 
Gam^aracter oneSestore = (GaiaeCharacter) is,readObject(} ; 
GamdCharactdt tvoRestore = (GameCharacter) is , readDb ject () ; 
GameCharacter threeRestore = (GameCharacter) is.readObjectO ; 



} 



Sys tea. out. println (''One's type: '' + oneRestore.getTypeO ) ; 
System. ou t.pr in tlD (''Two's type: " + twoRestore.getType() ) ; 
System. out. printlnC'Three's type: " + threeRestore, getType () ) 
catch (Exception ex) ( 
ex.printStac)cTrace() ; 
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The ^ameCharacter class 



inport java.io.*; 

public class GameCharacter isplements Serializable { 



type = t; 
weapons = w; 

} 

public int getPowerf) { 
return power; 

} 

public String getTypeO { 
return type; 

} 

public String getWeapons() ( 
String weaponList = '"'; 

for (int i = 0; i < weapons. length; i++) { 
weaponList += weapons [i] + ''; 

} 

return weaponList; 



int power; 
String type; 
String [] weapons; 




public GameCharacter (int p, String t, Stringf.] w) { 



power = p; 
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I BULLET POIH^^fc 

> You can save an object's state by serializing the object 

> To serialize an object, you need an ObJectOutputStream (from the 
java.io package) 

>^ Strean>s are either connection stneams or chain streams 

> Connection streams can represent a connection to a source or 
destination, typically a file, networ1( socket connection, or the 
console. 

> Chain streams cannot connect to a source or destination and must 
be chained to a connection (or other) stream. 

> To serialize an object to a file, make a RIeOuputStream and chain it 
into an ObjectOu^utStream. 

> To serialize an object, call writ^Object(theObjeci) on the 
ObJectOutputStream. You do not need to caW methods on the 
RIeOutpuiStream. 

> To be serialized, an object must implement the Seriallzable interface. 
If a superclass of the class Implements Serializable, the subclass will 
automatically be seriallzable even if it does not specifically declare 
implements Serializable. 

> When an object is serialized, its entire object graph Is serialized. That 
means any objects referenced by the serialized object's instance 
variat)ies are serialized, and any objects referenced by those 
objects-..andsoon. 

> If any object in the graph is not serializable, an exception will be 
thrown at mntime, unless the Instance variable referring to the object 
is skipped. 

> Mark an instance variable with the transient keyword if you want 
serialization to skip that variable. The variable v^rfll be restored as null 
(for object references) ordefeult values (for primitives). 

> During deserialization, the class of all objects In the graph must be 
available to tiieJVM. 

>^ You read objects in (using readObjectQ) in tiie order in Vi^ich they 
were orfginaity written. 

> The return type of readObjedQ is type Object, so deserialized 
objects must be cast to their real type. 

> Static variables are not serializedl It doesnl make sense to save 
a static variable value as part of a specific objecfs state, since all 
objects of that type share only a single value— the one in the class. 
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Writing a String to a Text File 

Saving objects, through serialization, is the easiest way to save and 
restore data between runnings of a Java program. But sometimes you 
need to save data to a plain oM text file. Imagine your Java program 
has to write data to a simple text liJe that some other {perhaps non- 
Java) program needs to read. You might, for example, have a servlet 
(Java code running within your web server) that takes form data the 
user typed into a browser, and writes it to a text fUe that somebody else 
loads into a spreadsheet for analysis. 

Writing text data (a String, actually) is similar to writing an object, 
except you write a String instead of an object, and you use a 
FileWriter instead of a FileOutputStream (and you don't chain it to an 
ObjectOutputStream) . 



To write a seriali2ed object: 

ObjectOutputStream. writeObject(soai60bject) ; 



r^i^K-t Iook1ik« i-f you ^o-te i-t 



60,Blf,bow, sword^duBt 
200,TroIl,bare handa^blg ax 
i20,MaglolAn,8peil84iivifiibillty 



To write a String: 

fileWritfir.write("My first String to save") ; 



import java.io. 



class Wrlt^AFile ( 

public static void main (String [] args) ( 



try { 

FileWritar writer = new FileWriter ("Foo . tact") ; 




writer, write (-hello foo!-) ;< TK^ w^it^O r^dhod U\ccs 

writer . close 0 ! , i 



) catch (lOExeeption ex) ( 
ex. prints tackTraceO ; 

} 
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text File Example: e-Flashcards 

Remember those flashcards you med in school? Where you 
had a question on one side and the answer on the back? 
They aren^t much help when you're trying to understand 
something, but nothing beats 'em for raw drill-and-practice 
and rote memorization. When you have to bum in a fact. And 
they Ve also great for trivia games. 

We*re going to make an electronic version that has three 
classes: 

1) QmzCtsrdBuUder, a simple authoring tool for creating and 
saving a set of e-Flashcards. 

2) QuhCcrdPIayery a playback engine that can load a 
flashc2Lrd set and play it for the user. 

3) QuizCard, a simple class representing card data. We*Il 
walk through the code for the buDder and the player, and 
have you make the QuizCard class yourself, using this > — ^ 




Jt&fiL 



File 



Which university is featured In the 
film "Ck>od Wili Hunting7 



MAX 



QuIzCard 



QulzCafd(q, a) 



question 
ar^swer 



getQuestionO 
gelAnswerO 



»9» 



E^^dX happens If you call 
Dbjea-gctPrimaryKeyO on a 
sion bean's remote reference? 



I 




QuizCardBuilder 

Has a File menu with q ^'Sove" option for saving 
the current set of cards to a text file. 



QuIzCardPlayer 

Has a F(/e menu with q "Load" option for loading a 
set of cards from a text fife. 
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Quiz Card l^uilder (code outline) 

public class QuizCardBuilder { 

public void goo { a-.s,ia.s ^ 

// build and display gui „a|ci„^ and r«yste'^"^a '^"""^ 

} 

Unev- diass 

private class NextCardListener implements ActionListener { *|»/e*i Ca^d' WtWi 

public void actionPerformed (ActionEvent ev) ( "^'^'^^''jt ««■ ^ 

// add the current card to the list and clear the text areas ^^^eltst a**** s'ta'ri a 

} 

} 

private class SaveMeniilistener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { ^ 

// bring up a me dialog box jj^^^^ I^ea^sTh/lT" V 

// let the user name and save the set ihc t^yds ih -/-k* ^ '*^^^^5hts io s^^e aff 

^ Java f^ules, rtdJ, ' ^^"ywood Trivia, 

private class NewMenuListener implements ActionListener { f » jt w -t^c f 

public void actionPerformed (ActionEvent ev) { 



// clear out the card list, and clear out the text areas mcav^^ ^^^r <s^^ 

J 1 ^„/4 i^'t 



} 



private void saveFile(Fae file) { 

// iterate through the list of cards, and write each one out to a text hie 
// in a pai^seable way (in other words, with clear separations bet^^een parts) 

} 

Cal!<rd by SaveMen\^»stci^cv^; 
docs iKc aeiual ^^^mg- 
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import java.util.*; 
import j ava.awt. event.*; 
import javax. swing. *; 
import java.awt.*; 
import java.io.*; 

public class QuizCardBuilder { 

private JTextArea question; 
private JTextArea answer; 
private ArrayList<Qui2Card> cardList; 
private JFrame frame; 



public static void main (String [] args) { 

QuizCardBuilder builder = new QuizCardBuilder () ; 
builder. go 0 ; 

} 



public void go {) { 

// build gui TKis Is Ml ^Ul tod 

frame = new JFrame (^^Quiz Card Builder"); jf^f^l ^/-feKoUAK u A^^'thii 

JPanel mainPanel = new JPanel {) ; lock ^4- A/f^^ n'^S^^ Wdh-^ 
Font bigFont = new Font ("sanserif Font. BOLD, 24); ^^d Me^Jl^^ ^^f^^^Oat, A/l^^,, 

question = new JTextArea (6, 20) ; "**'^»>^5 ^todc ' 
question. setLineWrap (true) ; 
question . setWrapStyleWord (true) ; 
question. setFont (bigFont) ; 



JScrollPane qScroller = new JScrollPane (question) ; 

qScroller.setVerticalScrollBarPolicy (ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS) ; 
qScroller. setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER) ; 

answer = new JTextArea (6, 20) ; 
answer. setLineWrap (true) ; 
answer. setWrapStyleWord (true) ; 
answer . setFont (bigFont) ; 

JScrollPane aScroller ^ new JScrollPane (answer) ; 

aScroller.setVerticalScrollBarPolicy (ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS) ; 
aScroller. setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER) ; 



JButton nextButton = new JButton ("Next Card"); 

cardList = new ArrayList<QuizCard> () ; 

JLabel qLabel = new JLabel (''Question: ") ; 
JLabel aLabel = new JLabel ("Answer:") ; 

mainPanel. add (qLabel) ; 
mainPanel. add (qScroller) ; 
mainPanel. add (aLabel) ; 
mainPanel. add (aScroller) ; 
mainPanel . add (nextButton) ; 

nextButton. addActionListener (new NextCardListener () ) ; 

JMenuBar menuBar = new JMenuBar ( ) ; 

JMenu fileMenu = new JMenu ("File") ; 

JMenuItem newMenuItem = new JMenuI tern ("New") ; 
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) 



JMenuItem saveMenuItem = new JMenuItem ('"Save") ; 

newMenuItem.addActionListener (new NewMenuListener ( ) ) ; , ^ k^r ^-.l *- 

SaveMenuItem, addActionListener (new SaveMenuListener () ) ; 't^**^ i^io p.i ^""^ ^v^' ^^^^ 

fileMenu.addlnewMenuItem) ; '»vc»iu ^ ii '^^^ Wt add li 

fiieMenu, add (saveMenuItem) / -f^j^^ i bat, i},^ i^u i,^ 

menuBar.add(£iieMenu) ; '^'^'^ ^ tiiu Jf" 

frame. set JMenuBar(menuBar) ; ^ 5h ^^i- c 

frame . getContentPane ( ) . add (BorderLayout . CENTER, mainPanel) ; tio^tv^^,^ 
frame- setSize (500, 600) ; 
frame . setVisibie (true) ; 



public class NextCIardListener ir^loznents ActionListener ( 

public void actionPerformed (ActionEvent ev) ( 

QuizCard card = new Qui zCard (question .getText () , answer .getText ()) ; 
cardList. add (card) ; 
clearCardO ; 

) 

) 

public class SaveNenuListaner iicplomeTits ActionListaner { 

public void act ionPerfonned (ActionEvent ev) ( 

QuizCard card = new QuizCard(question. getText () , answer .getText 0 ) ; 
cardList. add (card) ; ^ ^^^^ ^ 

$ps^ fiXfiSave - new JFileChoosdHH n - ^ a '^'^^rl^*^Sa>'^* ^^T-^^^r^ 

.e ftlleSav e , getSelectedFileO )>\^^B>— — J ^Vc*^ ^^^^ 




public class NewMenuListener implanientd ActionListaner { 

public void actionPerformed (ActionEvent ev) { 
cardList. clear 0 ; 
clearCardO ; 



) 



) 



question . requestFocus 0 ; -rv»c i ^^'^ 



private void ClearCardO I eW^oa '^?f j .ste^e^'* '''''^J!fw ia>'''^' 

question . setText < ) ; Th* ^ l ^V,c ^^^^T'> ^ft>c " ^ 

answer. setText ("") ; 




private void saveFlle<File file) { 
try { 

Buf feredWriter writer = new BufferedWriter (new FileWriter (lile) ) ; 

for(Qui2Card cardicardlist) ( '■^'^ ^ ^^feredWY\4-L l 

writer. write (card. getQuestionO +"/"); ) ^'^^^^ier h> i ^ 

writer, write (card. getAnswerO + "\n"); / ^IVell bik jk^^ ilT! ^iJ*^' 

writer .close 0 ; ^^^""^>>.^ 

) catch (lOException ex) I ^f^^^T^^^^^i^Usiof 
System. out. println("couldn' t write the cardList out"); i«vi-ti {}^f^ ^[.i ^> , j 

ex.printStackTrace 0 ; PO" lin«, wi{J, tK< qu>s+;J' , 5 
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The 



java.io.File 



class 



The java.io.File class represents z file on disk, but doesn*t 
actually represent the contents of the file. What? Thirtk of 
a File object as something more like a pathname o£ 2i file 
(or even a directory) rather than The Actual File Itself. 
The File class does not, for example, have methods for 
reading and writing. One VERY useful thing about a File 
object is that it offers a much safer way to represent a 
file than jiist using a String file name. For example, most 
classes that take a String file name in their constructor 
(like FileWriter or FilelnputStream) can take a File 
object instead. You can construct a File object, verify 
that you've got a valid path, etc. and then give that File 
object to the FileWriter or FilelnputStream. 



A File object represents the name 
and path of a file or directory on 
disk, for example: 

yUsers/Kathy/Data/GameFile.txt 

But it does NOT represent, or give 
you access to, the data in the filel 



Some things you can do with a File object: 

% Moke a File object representing on 
existing file 

Fil6 f = new File(^MyCodfl.txt"); 



@ Make a new directory 

File dir = now File ("Chapter?") ; 
dir.inkdirO ; 



List the contents of a directory 

if (dir.isDirGCtoryO) ( 

String[] dirContent^ = dir.listO; 
for (let i = 0; i < dirContents. length; iH) { 
System, out .println(dirCon tents [i] ) ; 



1 



) 



6et the absolute path of a file or directory 
Sys tern . out . pr in tin (dir . getAbsolutePath ( ) ) ; 



I v^l AT^'>« 

War UtM^'^^'' 



GameFlle.txt 



BO,Elf,bow, 8word,du3t 
200,Troll,bare hands.bi^ ax 
1 20,MaglQian,spells.jnvl8lblllty 

inside 



@ Oelcte a file or directory (returns true if 
successful) 

boolean isDeleted = f.deleteO; 
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The beauty of buffers 

If there were no buffers. It would be like 
shopping without a cart. You'd have to 
carry each thing out to your cor, one soup 
con or toilet paper roll at a time. 





String is put into o buffer 
with other Strings 



When the buffer i$ full, the 
Strings ore of) written to 



"Boulder" > 

IS written to 

String 



"Boidder^ "Aspen" 
"Denver" 



is chained to 



"/Aspen Oenver Boulder" 



BufferedWriter 
(q charn stream thot 
works with characters) 



Fi/eWriter 
(a connection stream 
that writes charocters 
OS opposed to bytes) 




BuffaradWrit^r writer = new BufferedWriter (new FilaWriter (aFile) ) ; 

The cool thing about buJffers is thai they're muchmore efficient than ^^icWk-ij^ ^i^^^ ^ 

working without them. You can write to a file using FUeWriter alone, by R^!lc^"^^ ^**^!ittouZ^^ 

calling write(someString), but FileWriter writes each and every thing you ^ tc^ai^ i 

pass to the file each and every time. That*3 overhead you don't want or ^ ^A^^i wcl/ call mrZ-kJ/ ^ 

need, since every trip to the disk is a Big Deal compared to manipulating J ^'^^^ ^losc £Ktf 

data in memory. By chaining a BufferedWriter onto a FUeWriter, the ^n^^^^' wi// {^j^^ 

BufferedWriter will hold all the stuff you write to it until it's full. Only when ^ o( ^^^-^ 
the buffer is full mil the FUeWriter actually be U>ld to write to the file on disk. 

If you do want to send data before the buffer is full, you do have control. 
Just Flush It Calls to writer,flush() say» ''send whatever 's in the buffer, new!" 



you are here > 453 



reading files 



Reading from a Text File 

Reading text from a file is simple, but this tiine we'll use a File 
object to represent the file> a FileReader to do the actual reading, 
and a BufTeredReader to make the reading more efficient. 

The read happens by reading lines in a xvhik loop, ending the loop 
when the result of a readUuQe() is null. That's the most comraon 
style for reading data (pretty much anything that's not a Serialized 
object) : read stuff in a while loop (actually a while loop tesf)y 
terminating when there's nothing left to read (which we know 
because the result of whatever read method we're using is null). 



A -file wrtK two lines o( tr^t 



What's 2 ^ 2?/4 
What's 20+22/42 



import java.io 



MyText.txt 



class ReadAFile { 

public static void main (String[] args) { 

try { r ^^^^^'^> i*.^ ^-itits.;^: 

File myFile = new File (^^MyText . txt") ; ^ 
FileReader fileReader = new FileReader (myFile) ; 



04r 



BufferedReader reader = new Buf feredReader (fileReadar) ; 



string line = null; 



while ((line » reader . readLine () ) <= null) ( 
System, out. println (line) ; 

reader . close ( ) ; S£h^ '^'''^t" ^'c'^'waifs^^i '9" '^i^ih, 

'>«<^u« there .TiLr^J ''"'K' ^ •^"ll 
} catch (Exception ex) ( ''«« thdi wa^ jw^ vead," P*"'"^ o^i 

ex.printStackTraceO ; Or SneA-^^ /« 



lines 
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Quiz Card Player (code outline) 

public class QuizCardPlayer { 

public void go 0 { 

// build and display gui 

} 

class NextCardlistener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 
// if this is a question, show the answer, otherwise show next question 
// set a flag for whether we're \dewing a question or answer 

} 

} 

class OpenMeniiUstener implements ActionListener { 
public void actionPerformed (ActionEvent ev) { 
// bring up a file dialog box 

// let the user navigate to and choose a card set to open 

} 

} 

private void loadFile(File file) { 

// must build an ArrayList of cards, by reading them from a text file 
// called from the OpenMenuListener event handler, reads the file one line at a time 
// and tells the makeCard() method to make a new card out of the line 
// (one line in the file holds both the question and answer, separated by a "/") 

} 

private void inakeCaFd(String lineToParse) { 

// called by the loadFile method, takes a line from the text file 

// and parses into two pieces — question and answer — and creates a new QuizCard 

// and adds it to tlie ArrayList called CardList 

} 
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import java.util.*; 
import java.awt. event.*; 
import javax. swing. 
import java.awt.*; 
import java.io.*; 

public class QuizCardPlayer { 

private JTextArea display; 
private JTextArea answer; 
private ArrayList<QuizCard> cardList; 
private QuizCard currentCard; 
private int currentCardlndex; 
private JFrame frame; 
private JButton nextButton; 
private boolean isShowAnswer; 



public static void main {String [] args) { 

QuizCardPlayer reader = new QuizCardPlayer () ; 
reader. go 0 ; 

} 

public void go() { 
// build gui 

frame = new JFrame ("Quiz Card Player"); 
JPanel mainPanel - new JPanelO; 

Font bigFont = new Font {''sanserif Font. BOLD, 24); 

display = new JTextArea {10, 20) ; 
display. setFont (bigFont) ; 

display. setLineWrap (true) ; 
display. setEditable (false) ; 

JScrollPane qScroller = new JScrollPane (display) ; 

qScroller.setVerticalScrollBarPolicy {ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAyS) ; 
qScroller. setHorizontalScrollBarPolicy(ScrollPaneConstants.HORIZONTAL_SCROLLBAR_NEVER) ; 
nextButton = new JButton ("Show Question"); 
mainPanel. add (qScroller) ; 
mainPanel .add (nextButton) ; 

nextButton. addActionListener (new NextCardListener () ) ; 

JMenuBar menuBar = new JMenuBar{); 
JMenu fileMenu = new JNenu ("File") ; 

JMenuItem loadMenuItem = new JMenuItem ("Load card set"); 
loadMenuItem. addActionListener (new OpenMenuListener () ) ; 
fileMenu. add (loadMenuItem) ; 
menuBar. add (fileMenu) ; 
frame . set JMenuBar (menuBar) ; 

frame. getContentPane () . add (BorderLayout. CENTER, mainPanel); 
frame. setSize (640,500) ; 
frame.setVisible (true) ; 

} // close go 



►•othmj special 
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public clasfl NoxtCardListftnar impleiaents ActionListener { 
public void actionPerfonned(ActionEvent ev) { 
if (isShowAnswer) { 

// show the answer because they've seen the question 
display .setText (currentCard.getAnswer {) ) ; 
nextButton,setText(''Next Card") ; 
isShowAnswer = false; 
else { 

// show the next question 
if (currentCardlndex < cardList . size {) ) 



} 



{ 



showNextCard () , 



else ( 

// there are no more cards 1 

display. setText (""That was last card''); 

nextButton.setEnabled(false) ; 



public class OpanManuListanftr implements ActionListener 
public void actionPerformed(ActionEvent ev) { 
JFileChooser fileOpen = new JFileChooser () ; 
fileOpen . showOpenDialog (frame) ; 
loadFile (fileOpen. getSelectedFile 0 ) ; 



) 



1 



private void loadFile (Fild file) { 

cardList = new ArrayList<QuizCard> ( ) ; 
try ( 

Buf feredReader reader = new Buf feredReader 
String line = null; 

while ((line = reader .readLine {) ) != null) 
makeCard(line) ; 

) 

reader .close 0 ; 

1 catch (Exception ex) { 

System. out. println C'couldn' t read the card 
ex.printStackTrace () ; 



// now time to start by showing the first card 
showNextCard (1 ; 

) 

private void makeCard (String linaToParaft) ( 

Stringd result = lineToParse. split CV") ; 
QuizCard card = new QuizCard (result (0) , result 
cardList . add (card) ; 
System. out, printin ("'made a card"); 



;aew FileReader (file) ) ; 



[1]); 



private void showNextCard () ( 

currentCard = cardList, get (currentCardlndex) ; 
currentCardIndex++; 

display. setText (currentCard. getOuestion () ) ; 
nextButton. setText (''Show Answer") ; 
isShowAnswer = true; 

} 

// close class 



file") ; 



Ic ti^t St.M splliO -cth-d y fc*^"^^' 

U tK* aww«r). Wt'll look at tKe 
sfW) f^oi <m the «<*t pay. 



you are here ► 457 



parsing Strings with spiit() 



Parsing with String spiitO 

Imagine you have a flashcard like this: 



^i^t Ifl blue + yeUow? 




Saved in a question file like this: 



How do you separate the question and answer? 

When you read the file, the question and answer are smooshed 
together in one line, seporoted by a forward slosh V (becouse 
thaf s how we wrote the file in the QuizCardBuilder code). 



Wliat is blue + yellow?/green 
What ifl red + blueV/purpls 



String split() lets you break a String Into pieces. 

The splitO method says, "give mc a separator, ond I'll break out oil 
the pieces of this String for you and put them in o String arra^." 




iWh at IB bl 

token 1 




separator token 2 



string toTest - "What is blue yelloH?/green"; 

String [ ] result = toTeat . split (V") ; t 'f^^^^ "ciW -Ukw the V" a>,d u^, ;^ i 

whdi wcVfi u^S ii (^ Vr^ Tf ^"T. ^^"^ 



for (String token: result) { 
Sya tern. out. println (token) ; 

1 f^s.. 
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-OK, I look In the API and th«re are about f!ve 



million classes In the java Jo package. How the heck cfo 1 i. *L C%|^|C 
you know which ones to use? 1 /v|3KC 



iyou 
A- 
^ -^-The I/O API uses the modular'chaining' concept so 

that you can hook together connection streams and chain 
L streams (also called 'Hlter' streams) in a wide range of 
I conr^binatfons to get Just about anything you could want. 

The chains don't have to stop at two levels; you can hook 
L multiple chain streanns to one another to get just the right 
1 amount of processing you need. 

Most of the time, though, you'll use the same 
L small handful of classes, if you're writing text flies, 
i BufferedReader and BufferedWriter (chained to FileReader 
f and FileWriter) are probably ail you needJf you're writing 

serialized objects, you can use ObJectOutputStream and 

ObJectlnputStream (chained to FllelnputStream and 

FileOutputStream), 

i In other words, 90% of what you might typically do with 
I Java I/O can use what weVe already covered. 

9; 
A- 

-Ml-The Java.nio classes bring a big performance 
Improvement and take greater advantage of native 
' capabilities of the machine your program is running 
on. One of the key new features of n!o is that you have 
direct control of buffers. Another new feature is non- 
i blocking I/O, which means your i/0 code doesn't just sit 
f there, waiting, if there's nothing to read or write. Some 
of the existing classes (Including FllelnputStream and 
nieOutputStream) take advantage of some of the new 
features, under the covers. The nio classes are more 
I complicated to use, however, so unless you really need the 
I new features, you might want to stick with the simpler 
versions we've used here. Plus, If you're not careful, nio can 
lead to a performance /oss.Non-nio I/O is probably right 
for 90% of what you'll normally do, especially if you're Just 
getting started In Java. 

But you can ease your way Into the nio classes, by using 
I filelnputStream and accessing Its c/)or)ne/ through the 
rgetChannelO method (added to FilelnputStream as of 
t^ersion 1 .4). 



What about the new I/O nio classes added In 1 .4? 



,S(tf» and Wir/t.w ere ofrfj^ftK^ 



To write a text file, start with a FileWriler 
connection stream. 

Chain the FileWriter to a BufferedWriter for 
efficiency. 

A File object represents a file at a particular 
patii, but does not represent the actual 
contents of the file. 

With a File object you can create, traverse, 
and delete directories. 
Most streams that can use a String filename 
can use a File object as well, and a File object 
can be safer to use. 

To read a text file, start with a FileReader 
connection stream. 

Chain the FileReader to a BufferedReader for 
efficiency. 

To parse a text file, you need to be sure the 
file is written with some way to recognize the 
different elements. A common approach is to 
use some Idnd of character to separate the 
individual pieces. 

Use the String spIitQ nnethod to split a String 
up Into individual tokens. A String with one 
separator will have two tokens, one on each 
side of the separator. The separator doesnt 
count as a token. 
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Version IP: A l^ig Serialization Gotcha 

Now you've seen that I/O in Java is actually pretty simple, especially if 
you stick to the most common connection/chain combinations. But 
there's one issue you might wally care about 

Version Control is crucial! 

If you serialize an object, you must have the class in order to 
deserialize and use the object. OK, that's obvious. But what might 
be less obvious is what happens if you change Ihe class in the 
meantime? Yikes. Imagine trying to bring back a Dog object when 
one of its instance variables (non-transient) has changed from a 
double to a String. That violates Java's type-safe sensibilities in a Big 
Way. But that's not the only change that might hurt compatibility. 
Think about the following: 



Changes to a class tiiat can liurt deserialization: 

Deleting an instance variable 

Changing the declared type of an instance variable 

Changing a non-transient instance variable to transient 

Moving a class up or down the inheritance hierarchy 

Changing a class (anywhere in the object graph) from Serializable 
to not Serializable (by removing 'implements Seriahzable' from a 
class declaration) 

Changing an instance variable to static 

Clianges to a class tliat are usually OK: 

Adding new instance variables to the class (existing objects will 
deserialize with default values for the instance variables they didn't 
have when they were serialized) 

Adding classes to the inheritance tree 

Removing classes from the inheritance tree 

Changing the access level of an instance variable has no affect on 
the ability of deserialization to assign a value to the variable 

Changing an instance variable from transient to non-transient 
(previously-serialized objects will simply have a default value for the 
previously-transient variables) 



You write a bog class 



lOllOl 
lOlOlOOMlO 
1.010 10 0 
01010 1 
1010101 
IDiOlOlO 
1001010101 



Dog. class 



You serialize a Dog object 
usirvg that class 




You change the Dog doss 



101101 

101101 

101000010 
1010 10 0 
OtOlO 1 
lOOOOl 1010 

0 00110101 

1 0 1 10 10 



tlass vers>o»» 



IP 



Dog.class 



You 6eszr\a\\ze a Dog object 
using the changed c\ass 




^ Dog.class 



Serailization fails!! 

The JVM says, "yo<J can't 
teach an old Dog new code" 
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Usmg the serlalYersionUIP 

Each dme an object is serialized^ the object (incJuding 
every object in its graph) is 'stamped' with a version 
ID number for the object's class. The ID is called 
the serialVersionUlD» and it*s computed based on 
information about the class structure. As an object is 
being deserialized, if the class has changed since the 
object was serialized, the class could have a different 
serialVersionUID^ and deserialization will fail! But you 
can control this. 

If you think there Is ANY poBslbillty that 
your class might evolve, put a serial version 
ID In your class. 

When Java tries to deseriahze an object, it compares 
the serialized object's serialVersionUID with that of the 
class the JVM is using for deserializing the object For 
example, if a Dog insunce was serialized with an ID of, 
say 23 (in reality a serialVersionUTD is much longer), 
when the JVM deserializes die Dog object it will first 
compare the Dog object serialVersionUID with the 
Dog class serial VersionU ED. If the two numbers don't 
match> the JVM assumes the class is not compatible 
with the previously-serialized object, and you'll get am 
exception during deserialization. 

So, the solution is to put a serialVersionUID 
in your class, and then as the class evolves, the 
serialVersionUID will remain the same and the JVM 
will say, "OK, cool, the class is compatible with this 
serialized object." even though the class has actually 
changed- 

This works only if you're careful with your class 
changesl In other words, you^re taking responsibility 
for any issues that come up when an older object is 
brought back to life with a newer class. 

To get a serialVersionUID for a class, use the serialver 
tool that ships with your Java development kit. 



I File Edit winder NdTp $«rlalKIIidr 



^6 serialver Dog 

Dog: static final long 
serialVersionUID = - 
5849794470654667210L; 



When you think your class 
might evolve after someone has 
serialized objects from it... 



Use tHe serialver command-line tool 
to get the version lb for your class 

|nf6 EdH Windw/ Hefp seriaiKiit&f ~ 



1 



%: serialver Dog 

Dog: static final long 
serialVersionUID = - 
5849794470654667210L; 



Paste the output ir\to your class 
public class Dog { 



r 



ttte filial ICH&g; iiierialVArsicml 
-6S497d447 



private Stxing namft; 
private int size; 

// method cod« hare 



Be sure that when you moke changes to 
the class, you take responsibility rn your 
code for the consequer\ce£ of the changes 
you made to the classi For example, be 
sure that your new bog cIqs& can deal with 
an old Dog being deserfaN2ed w/th default 
values for instance variables added to the 
das& after the Dog was serialized. 
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Code Kitchen 



Cofte Kitdien 



Cyber Bea^x :^' 



^l^vDm^^ 295 C start ) 

" Stbp 3 




Open m-fM 

^<mskUkim DOnOODOD □ □ □ □ □ □ □ 

^hm^ao □ □ □ ^ 

Han^bap 
High Tom 
HI Bon^o 

Low Conga 



ao o o e o o □ □ □ SB a s e a ( ^^""^ ) 
^□□□□□□□□□□□□□□□r«*^ 
oacoaaDDooooacca 
aoaQdQaaoaQDDGGQ ~ 
□QooaoooacaGOCGO ^ 




'tow-mw Tom QC G □ □ □ O Q G G G G G G SO 

High Agogo 0000 DSQ B □ O O ^BBB Q 
Open HK 



Let's make tke BeatBox save anct 
restore our favorite pattern 
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serialization and file I/O 

Saving a l^ealf ox pattern 

Remember, in the BeatBox, a drum pattern is nothing more than a bunch of 
checkboxes. When it's time to play the sequence, the code walks through the 
checkboxes to figure out which drums sounds are playing at each of the 16 
beats. So to save a pattern, all we need to do is save the state of the checkboxes. 

We can make a simple boolean array, holding the state of each of the 256 
checkboxes. An array object is serializable as long as the things in the array are 
serializable, so we'll have no trouble saving an array of booleans. 

To load a pattern back in, we read the single boolean array object (deserialize 
it), and restore the checkboxes- Most of the code you've already seen, in the 
Code Kitchen where we built the BeatBox GUI, so in this chapter, we look at 
only the save and restore code. 

This CodeKitchen gets us ready for the next chapter, where instead of writing 
the pattern to a^ife, we send it over the network to the server. And instead of 
loading a pattern in from a file, we get patterns from the server, each time a 
participant sends one to the server. 



Serializing a pattern 

TWis U mv^CV- tlass \^^dt 

tmblic class MySendListener implements ActionListener { ,^ ». lx 

\i all V,a?pe.s 

public void actionPerf ormed (ActionEvent a) { ^ ^ button and i^t /^dtionl^vcnt t>rc - 



boolean!] checkboxState new boolean [256] ; 

for ,i„t 1 - O; 1 < 256; i+t, ( "f ^wSb™. 



JCheclcBox check = (JCheckBox) checkboxList.get(i) ; Waik 

°o "t to the beolear, a^-^^av/ 



if (check. isSelectedO) { ^)^*ravJA**l* 'm*'*'^'^'-'** 

CheckboxState [i] = true; ^t^"^'^' 



try { 

FlleOutputStream fileStream = new FileOutputStreain(new File ("Checkbox. ser") ) ; 

ObjectOutputStream os = new ObjectOutputStream(fileStraam) ; 

OS. writeObject (checkboxState) ; _ 
} catch (Exception ex) { ' Pf>"£4 a piede of take Xk4- 

J ex.printStackTraceO ; ^.teAeHali^ ^he o.e b<>olcaTa^,yl 

} // close method 
) // close inner class 
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deserializing the pattern 



Restoring a PeatVox pattern 

This is pretty much the save in reverse.., read the boolean array and use it 
to restore the state of the GUI checkboxes. It all happens when the user hits 
the "restore"* 'button. 



Restoring a pattern 

public class MyRaadlnListanar implemezits ActdciilListAnar ( 



public void actionPerformftd(ActionEvant a) { 
boolean [] checkboxState = null; 
try ( 

FilelnputStroam filain - naw 7ilttInputStx«Bm(am File C'Checltbox. aar'^) ) ; 
ObjectlnputStxaam is « new ObjactlnpiitStraam(fileln) ; ^ 
chackboxStata = (boolean [ ] ) ia . raadObjact () ; ^Mle Jb\tci m tV^€ Y\\t 

) catch (Exception ex) { ax . printStackTraca ( ) ; ) V^ltBr, arr^Y (vcmCF^Wr, y^edd^yW^ 

for (int i 0; i < 256; i++> ( 

JChackBox check = (JChackfiox) oheokboxList .get (i) ; 
if (chackboxStatati]) { 

check. fletSelactftd( true) ; t^ow tt^io^^ ^Ke rta^ J ^jiaU J: II 



) «18« { 

ch«c]c.a«tSslact«d (falsa) ; 

) 



) 



aequancar . sfcop ( ) ; 
buildTcacfcAndStartO , 

) // closa mthod 
) // cloB« inner class 



pen your pencil 



This version has a huge limitation] When you hit the'serlallzelfbuttonjl 
serializes automatically, to a file named "Checkbox.ser" (which gets created if it 
doesn't exist). But each time you save, you overv^rlte the previously-saved file. 

Improve the save and restore feature, by Incorporating a JFIIeChooser so that 
you can name and save as many different patterns as you like, and load/restore 
from any of your previously-saved pattern flies. 
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rpen your pencil 



Can Aey be saved? 

Which of these do you think are, or should be, 
serlallzabte? If not; why not? Not meaningful? 
Security risk? Only works for the current 
execution of the JVM? Make your best guess, 
without looking it up in the API. 



Object type 


Seriallzable? 


Object 


Yes / No 


String 


Yes / No 


File 


Yes / No 


Date 


Yes / No 


OutputSfream 


Yes / No 


J Frame 


Yes / No 


Integer 


Yes / No 


System 


Yes / No 



If not, why not? 



HVharsLegalP 

Dircle the code fragments 
Ihat would compile (assuming 
they're within a legal dass). 




FileKe&der fileRaiidar = new FilaRaaderO ; 
BufferadRaadar raadar = new Buf faradRaadar (fileRaadar) ; 

FilaOutputStraaa f = naw FilaOutputStream(new File {"Foe. aar") ) ; 
Objact^Outputatraam os - naw ObjactOutput:Straam(f ) ; 



BuffaradReadar raadar = naw BuffaradRaadar (new FilaReadar (&la] ) ; 
Stxing lina = niill; 

whila ((lina - raadar . raadLine () ] != null) { 
makaCard(lina) ; 

) 

QbjectInput:Straa3n is = new ObjectanputStreaiD(naw FileOutputStraain(*'GaiDe,ser")) ; 
GameCbaracter onaAgain = (GaineCbaracter) ifi.readObjactd ; 
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exercise: True or False 




This chapter explored the wonerful world of 
Java I/O. Your Job is to decide whether each 
of the following l/O-related statements is 
true or false. 



1. Serialization is appropriate when saving data for non-Java programs to me. 

2. Object state can be saved only by using serialization. 

3. ObjectOutputStream is a class used to save serialized objects. 

4. Chain streams can be used on their own or with connection streams. 

5. A single call to writeObject() can cause many objects to be saved. 

6. All classes are serializable by default 

7. The transient modifier allows you to make instance variables serializable. 

8. If a superclass is not serializable then the subclass can*t be serializable. 

9. When objects are deserialized, they are read back in last-in, first out sequence. 

10. When an object is deserialized, its constructor does not run. 

11. Both serialization and saving to a text file can throw exceptions. 

12. BufferedWriters can be chained to FileWriters. 

13. FiJe objects represent files, but not directories. 

14. You can't force a bufifer to send its data before It's full 
15- Both file readers and file writers can be buffered. 

16. The String splitO method includes separators as tokens in the result array 

17. Any change to a class breaks previously serialized objects of that class. 
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serialization and file I/O 



CoJe Marfnets 

This one's tricky, st) we promoted it from an Exercise to full Pu22le status. 
Reconstruct the code snippets to make a working Java program that 
produces the output listed below? (You might not need all of the magnets, 
and you may reuse a magnet more than once,) 



class DuuqeonGaffie 



implements Serializable { 




System. out. println ( d. getX( )+d.getY( )+d.getZ() ) ; 



FilelnputStream fis = new |ublic int x = 3; 
FiLelnputStreamC'dg.aer" ) ; Iransient long y =^ 4;| 

private short 2=5; 

long 




d = (DungeonGame) ois . readOb ject ( ) 7 



Ob jectOutputStream 00s = new 
0bject0utputStreain(fo3) ; 



oos 



.writeObject(d) ; 



DungeonGaine d - new DungeonGaiae 
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exercise solutions 

1. Serialization is appropriate when saving data for non-Java programs to use. False 

2. Object state can be saved only by using serialization. False 

3. ObjectOutputStream is a class used to save serialized objects. True 

4. Chain streams can be usedon their own or with connection streams. False 

5. A single call to writeObject() can cause many objects to be saved. True 

6. All classes are serializable by default. False 

7. The transient modifier allows you to make instance variables serializable. False 

8. If a superclass is not serializable then the subclass can't be serializable. False 

9. When objects are deserialized they are read back in last-in, first out sequence. False 

10. When an object is deserialized, its constructor does not run. True 

11. Both serialization and saving to a text file can throw exceptions. True 

12. BufiferedWriters can be chained to FileWriters. True 

13. File objects represent files, but not directories. False 

14. You can't force a buffer to send its data before it's ftall. False 

15. Both file readers and file writers can optionally be buffered. True 

16. The String split() method includes separators as tokens in the result array. False 

17. Any change to a class breaks previously seriahzed objects of that class. False 
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serialization and file I/O 



import java-io-*; 



class DungeonGame implements Serializable { 
public int x = 3; 
transient long y = 4; 
private short z = 5; 
int getxo { 
return x; 



long getY( ) { 
return y; 

} 

short getZ ( ) { 
return 2; 



> 



} 



class DungeonTest { 

public static void main{ String [] args) { 
DungeonGame d - new DungeonGame{ ) ; 

System-oat.println(d»getX( ) + d*gQtY{) + d.getZ()); 
try < 

FileOutputStreaia fos = new FileOutputStream( "dg. ser" ) ; 
ObjectOutputStream cos = new ObjectOutputStreain(fos) ; 
oos -writeObject (d) ; 
oos -close ( ) ; 

FilelnputStreajn fis = new FilelnputStream( "dg . ser" ) ; 
ObjectlnputStream ois = new Ob jectInputStream(fis ) ; 
d = (DungeonGame) oi8-read0bject( ) ; 
ois . close ( ) ; 
} catch (Exception e) { 
e.printStac)cTrace{ ) ; 

> 

System. out .println(d.getX{ ) + d.getYO + d.getZ()); 



¥ java DungeonTest 

12 

8 
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1 5 networking and threads 



Make a Connection 




Connect with the outside world. Your Java program can reach out and touch a 
program on another machine. It's easy. All the low-leve[ networking details are taken care of by 
classes in the java.net library. One of Java's big benefits is that sending and receiving data over 
a network is just I/O with a sllghtiy different connection stream at the end of the chain. If youVe 
got a BufferedReadenyou can reod.And the BafferedReader could care less if the data came 
out of a file or flew down an ethernet cable. In this chapter we'll connect to the outside world 
with sockets. We'll make c//enf sockets. Well make jerve^ sockets. We'll nnake c//enfs and servers. 
And we'll make them talk to each other Before the chapter's done, you'll have a fully-funaional, 
multithreaded chat client. Did we just say multithreaded! Yes, now you will learn the secret of 
how to talk to Bob while simultaneously listening to Suzy. 
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t box chat 



Bass Drum gG C Q 8 Q O OMOQ □ SO O Q 
aos*d Hi: Hat QG S C □ C 0 Sf □ □ 800 □ SW. 

openHi-Hat □□□□□oQsesBOQoaa 

Acoostk Snare □ □ □ □ □ O D O O O □ G O O □ 
Crash Cymbal COGGC ^ □ □ IjGDGQOO 
Hand Gap Q C G G GG G □ G 000 OG CG 
High Tom G G G GG GOO 00000.000 
Hi Bon^o G G G G G O G G G d G G Mil MB 

Maracas g G 0G S G B UM O S O SO fl O " 

whistJe GGGGGGdOGCGGGGGG 

low Conga .aeoooosoessosoaa 

Cowbell ESS 0 BQOiB BB d O QO O Q Q 
vibrasiap DGOBBBeBOBQeQQQQ 
Low-midTom GGaOOdQBOBOOQGOG 
High Agogo G G GO G O GOO O O GOG 0 O 

Open Hi CongaC G □ if MS □ G G G G □ SMi! G 



( Start > 



tiy this one... tfs better for 
sequenced 



I s)cylef4: fast and funky, good for 
!sftQiience12 

I evster2: like skytera, birt more 
-j Oakenfoldhh 

: Bk yterf; you WtSHl Too pe rky 



vo.«.."".»-,sr^s=-^"-rr ^^^^ 

are doing the ^o^^^.^f^^^, ^eat Box, your leara 
Using a 'chat' version of *e d ^^^g 
Sor.te-you Beat Box Cha. 

your cha. n^^-^f 'f^^^^euo read^^ other 
gets it SO you Jf 1^ get to ioad and r» ©5 
participants' ^y decking the 

'^^^nCtcSn Jessagesarea. 
n^essage >n m i^.^^hatu 

,n this chapter we r gmS ,^.V;e're 

^,es to make a d^t c " 

e^en going to ^eam a itu ^hat 

text messages. 




you Ut^ Have iomylftilyi 

meisajc ii ^CT^i to all 
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Chat Program Overview 

Tke Client lias to Icnow 
ahoiittlie Server- 

The Server hs toliw 
about ALL tlieCliei^. 



How It Works: 

^ client connects to the server 



^ The server makes a 

connection and adds the client 
to the list of participants 

^ Another client connects 



Q Client A sends a message to 
the chat service 



The server distributes the 
message to ALL porticipants 
(including the original sender) 





Client C 



Sorter, like to tcntytti 



Client A 
Client A 





|4 Oi(, youVe in- — 



#1 PlM^iiiiiti; 

l-ClfenlAj 



Client B 




Server 



VKo took tKe lavi Idrrsf 



CKOTt A 

Client A .]■■■ 
Client B 




Server 



VKo took tke Uvd Umf _ 

(row my drtTTw iroom?' 



Server 
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socket connections 



CoHneeting, Sending, and Kecelviha 



The three things we have to leam to get the client working are : 

1) How to establish the initiaJ connection between the client and server 

How to send messages to the server 
3) How to receive messages from the server 

There's a lot of low-levei stuff that has to happen for these things to work. But we're 
lucky, becaiise the Java API networking package (java,net) makes u a piece of cake 
for programmers. You'll see a lot more GUI code than networking and I/O code. 

And that's not all. 

Lurking within the simple chat client is a problem we haven't faced so far in this 
book: doing two things at the same time. Establishing a connection is a one-time 
operation (that either works or fails). But after that, a chat participant wants to 
send outgoing messages and simultaueoasly receive incoming messages from the other 
participants (via the server), Hmmmm... that one s going to take a little thought, but 
we*ll get there in just a few pages. 



O Connect 



Client connects to the server by 
establishing a Socket connection. 




Client A 



Server 



O Send 



Client sends a message to the server 




Client A 



Server 



O Receive 



Client gets a 



message from the server 



g. 



U— Sfa-ih^ s - reader .^dLlrcO 




Server 



Cl/ent A 
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Make a network Socket coimectioh 

To connect to another machine, we need a Socket connection. 
A Socket ( java.net.Sockei class) is an object that represents 
a network connection between two naachines. What*s a 
connection? A relationship between two machines, where two 
pieces of software know about each other. Most importantly, 
those two pieces of software know how to aminunicatemth 
each other In other words, how to send bits to each other. 

We don't care about the low-level details, thankfully, because 
they're handled at a much lower place in the 'networking 
^ck'. If you don*t kjaow what the 'networking stack' is, don't 
worry about it It's just a way of looking at the layers that 
information (bits) must travel through to get from a Java 
program running in a JVM on some OS, to physicaJ hardware 
(ethemet cables, for example), and back again on some other 
1 machine. Somebody has to take care of all the dirty details. 
liBut not you. That somebody is a combination of OS^pecific 
, software and the Java net>vorking API. The part that you have 
* worry about is high-level — make that very high-level — and 
lockingly simple. Ready? 



chatSocket = new Socket (^^196 . 164 . 1 . 103' 



To make a Socket 
connection, you need 
tofoowtwotei^S 
about ihe server- 
itiS,andwfccliport 
ifs running on. 

In o&t&T words, 

IP address and TCP 
part nimiber. 




5000) ; 





CI rent 



Server 



A Scx3tet ccwvnection means Ae two macliines liave 
information aboiit each odier, including network 
location (IP address) aotid TCP port. 
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well-known ports 



A TCP port is just a number 

A 1 e-bit number that identifies 
a specific program on the server 



Your internet web (HTTP) server runs on port 80. That's a 
standard. If you*ve got a Telnet server, its running on port 
23. FTP? 20. POPS mail server? 110. SMTP? 25. The Time 
server sits at 37, Think of port niimbers ^s unique identifiers. 
They represent a logical connection to a particular piece of 
software running on the server. That's it. You can't spin your 
hardware box around and find a TCP port For one thing, 
you have 65536 of them on a server (0 - 65535). So they 
obviously don't represent a place to plug in physical devices. 
They're just a number representing an application. 

Without port numbers, the server would have no way of 
knowing which application a client wanted to connect to. 
And since each application might have its own unique 
protocol, think of the trouble you'd have without these 
identifiers. What if your web browser, for example, landed 
at the P0P3 mail server instead of the HTTP server? The 
mail server won't know how to parse an HTTP requesti And 
even if it did, the POPS server doesn*t know anything about 
servicing the HTTP request 

When you write a server program^ you'll include code that 
tells the program which port niunber you want it to run on 
(you'll see how to do this in Java a litde later in this chapter). 
In the Chat program we*re writing in this chapter, we picked 
5000. Just because we wanted to. And because it met the 
criteria that it be a number between 1024 and 65535. Why 
1024? Because 0 through 1023 are reserved for the well- 
known services like the ones wejust talked abouL 

And if you're writing services (server programs) to run on 
a company network, you should check with the sys-admins 
to find out which ports are already taken. Your sys-admins 
might cell you, for example> that you can't use any pon 
number below, say, 3000. In any case, if you value your limbs, 
you won't assign port numbers with abandon. Unless it's 
your home network. In which case you just have to check with 
your kids. 



Wcll-knowf\ TCP port numbers 
for common server applications 




A sfv^er Kive up io i>^^^ 
di^-f cve»\i server apps v-utmm^ 
one per por-L 



The TCP port 
runnbers frcnn o to 1023 
are reserved for weU- 
Itnown services. Don't 
use Aem for your own 
server programs!* 

The chat server we're 
wrifcing uses port 
5000. We just picked a 
number between 1024 
and 65535. 



'Well, yoL) might b« able to use one of 
these, but the sys-admin where you 
work will probably kill you. 
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How do you know the pori 
number of the server program you 
want to talk to7 



A: 



That depends on whether the 
program is one of the well-known 
services. If you're trying to connect 
to a well-known service, like the ones 
on the opposite page (HTTP, SMTP, 
ifTP, etc) you can look these up on 
rthe Internet (Google "Well-Known 

TCP Port"), Or ask your friendly 
k i>efghborhood sys-admin, 

pBut if the program isn't one of the 
well-known services, you need to 
^find out from whoever \s deploying 

tie service. Ask him. Or her Typically, 
If someone writes a network service 
id wants others to write clients for 
it, they'll publish the IPaddress^port 
aumbenand protocol for the service. 

^example, if you want to write a 
H^nt for a GO game server, you can 
fish one of the GO server sites and 
find information about how to write a 
lUJient for that particular server. 



Can there ever be more than 
) program running on a single 
»rt7 In other words, can two 
applications on the same server have 
\ same port number? 



A: 



No! ff you try to bind a program 
to a port that is already in use.you'li 
t a BindException.To bind a program 
a port ju^t means starting up a 
server application and telling It to run 
I on a particular port. Again, you'll learn 
I more about this when we get to the 



IP addvcss is IKc mall 



IP address \$ like specifying a 
particular shopping maJl, soy, 
TIatirons Marketploce" 




0 specific store, soy, 
•BoKs Cb Shop" 




Brain Barbell 



OK, you got a Socket connection. The client and the 
server know the IP address and TCP port number for 
each other Now what? How do you communicate 
over that connection? In other words, how do you 
move bits from one to the other? Imagine the kinds of 
messages your chat client needs to send and receive. 

Client 




Server 



ym^mm^ All 



reading from a socket 



To read data from a Socket use a 
PufferedReader 

To commuriicate over a Socket connection, you use sureams. 
Regular old I/O streams, just like we used in the last chapter. One 
of the coolest features in Java is that most of your I/O work won't 
care what your high-level chain stream is actually connected to. In 
other words, you can use a BufferedReader just like you did when 
you were writing to a file, the difference is that the underlying 
connection stream is connected to a Socfe^ rather than a File! 




Make Q Socket connection to the server 



o 



Socket chatSocket = new Socket (''127 . 0 . 0 . 1", 5000); 

Make an InputStreamReader chained to the Sockets 
low - levc I (connection) input strea m 

InputStreamRfiader stream = new InputStraamReader (chatSocket . getlnputstreaxn () ) ; 



o 



Moke a BufferedReader and readi 



BufferedReader reader = new BufferedReader (stream) 
String message - reader . readLine () ; 



buffered characters converted to characters bytes from server 



buffered 
characters 



chained to 



characters 



chained to 



Client 



BufferedReader 



InputStreomReader 



Socket's input stream 
(we don't need to know 
the actuol class) 




Server 
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To write data to a Socket use a 
PrihtWrlter 

We didn't use PrintWriter in the last chapter, we used BufferedWriter. We have 
a choice here, but when you're writing one String at a dme, PrintWriter is the 
standard choice. And you*ll recognize the two key methods in PrintWriter, 
printO and println()I Just like good ol' System. out- 



Make a Socket connection to the server 



Socket chatSocket = new Socket (^U27 . 0 . 0 . 1", 5000); 



Moke c PrintWriter chained to the Socket's low- level 
(connectfon) output stream 

PrintWriter writer = new PrintWriter (cbatSocket.getOutputStreamO > ; 



r 



Write (print) something 

writer .pr in tin (''message to send'') ; 
writer»print(''another message");^ 



7 



O- 



Cflent 



choracters 



bytes to server 



message... 



1 



► 

chained to 



PrintWriter 




Socket's output 
stream (we don't rieed 
to knofcv the flcfua/ class) 



Server 
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writing a client 



The PailyAdviceClieht 

Before we start building the Chat app, 
let's siart with something a little smaller 
The Advice Guy is a server program that 
offers up practical, inspirational tips 
to get you through those long days of 
coding. 

We're building a client for The Advice 
Guy program, which pulJs a message 
from the server each time it connects. 

What are you waiting for? Who knows 
what opportunities you've missed 
without this app. 



Treat yourself to 
a cold one) You 
deserve it) 



Tell your boss 
the report will 
have to wait. There's 
powder at AspenI 




O Connect 



Client connects to the server and gets an 
input streom from it 

Client 





Server 



© Read 



Client reads a message from the server 





Client A 



Server 
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PailyAdvieeClieHt code 



This program makes a Socket, makes a Bufferedfteader (with the 
help of other streams), and reads a single line from the server 
application (whatever is running at port 4242). 



import java.io.*; 
import java.net.*; 



p\2blic class DailyAdviceClient ( 



public void go() { 



try { 



a lot 



Socket s = new Socket (^^127. 0.0.1", 4242); 

Inputs treamReader streaioReader = new Inputs treamReader (s.getlnputStreamO } ; 
BufferedReader reader = new BufferedReader (s treamReader) ; ^^^j^ ^ 

mf^i stv-tfam tvom tKc 

Soeket. 



string advice = reader . readLine () ; 
System. out. prin tin (^^Today you should: 



+ advice) 



reader. close () ; tfe tlcst^ ALL- tiie st^caws 



} catch ( lOException ex) { 
ex. prints tackTraceO ; 

} 



) 



public static void main (String [ ] args) ( 

DailyAdviceClisnt client = new DailyAdviceClient () ; 
client. go 0 ; 

) 
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socket connections 



rpen your pencil 



Test your memory of the streams/classes for reading and writing from a 
Socket. Try not to look at the opposite pagel 



To read text from a Socket; 



Client 



^ic/drh^ m {yt 4kaift of streams i^t tUtwi 




Server 



To send text to a Socket 



Client 



wrrt^/drdw in tKe ^Kiirv of ^tAri^ the t\\tni 
uses -to iet^d somrtKinj ho t>>e sct*vc%- 



Oh 




Server 



p-4^^rpen your | 

Fill In 



pencil 



the blanks: 



What two pieces of information does the client need in order to make a 
Socket connection with a server? 



Which TCP port numbers are reserved for 'well-known services' like HTTP and FTP? 



TRUE or FALSE: The range of valid TCP port numbers can be represented 
by a short primitive? 
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Writing a simple server 

So what's it take to write a server application? Just a 
couple of Sockets. Yes, a couple as Ln two. A ServerSocket, 
which waits for client requests (when a client naakes a 
newSocketO) and a plain old Socket socket to use for 
cormnunication with the client. 



How it Works: 



Server cpplfcation makes a ServerSocket, on q specific port 

SarverSocket aerverSock = new SarvarSockat (4242) ; 

This starts the server application listening 
for client requests coming in for port 4242. 





^ Client makes a Socket connection to the server application 

Sockat sock = new Socket (*^190 . 165 . 1 . 103" , 4242); 

Client knows the IP address and port number 
(published or given to him by whomever 
configures the server app to be on that port) 




Server makes a new Socket to communicate with this client 

Socket sock = aarverScck. accept () ; 

The QcceptO method blocks (just sits there) while 
it's waiting for o client Socket connection. When a 
client finolly tries to connect, the method returns 
a plain old Socket (on a different port) that knows 
how to communicate with the client (i.e.. knows the 
dienfs IP address and port number). The Socket is on 
a different port than the ServerSocket, so that the 
ServerSocket can go back to waiting for other clients. 
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PailyAdviceServer code 

This program makes a ServerSocket and waits for client requests. When it gets 
a dient request (i.e. client said new Socket() for this application), the server 
makes a new Socket connection to that client. The server makes a PrintWriter 
(using the Socket's output stream) and sends a message to the client. 



import java.io.*; ^,^e-Wv '^^^"^ ^^^^ ^^^^^^T'^T^^^^^ 

import java.net.*; i\it todt t^y^- ^^^f".. 

public class DailyAdviceServer { ^^.^^ ^^^-^^^ tomCi -from tWvs arva^ ^ ^ gir\^(^\) ^ 

String [] adviceList = {''Take smaller bites", ''Go for the tight jeans. No they do NOT 
make you look fat.'', "One word: inappropriate'', "Just for today, be honest. Tell your 
boss what you *really* think", "You might want to rethink that haircut."} ; 



public void go() { 
try { 

ServerSocket serverSock = new ServerSocket (4242) 



while (true) { . t*** at£«ft wetKod blotks (just si-b ihev-e) until a 

ire«\uest domes in, and th«n tKe wetKod vetuvns a 

Socket sock = serverSock . accept ( ) ; ^J'«i f *^ dommunieatinj 

with the dlient 

PrintWriter writer = new PrintWriter (sock. getOutputStreamO ) ; 
String advice = getAdvice ( ) ; 



) 



writer. println (advice) ; ^ „ 
writer.closeO ; ^^--^ ^^k, , Py-m^.VhL Tl'^'fi'^ ^^'''"^ ^ 

Syste«.out.println(advice) ; ^ advide .essa^ft w Z UttJli' '^'"'^ 

^t'rc done with this dlient. ^ 



} catch (lOException ex) { 
ex.printStackTrace 0 ; 

} 

) // close go 

private String getAdvice () { 

int random - (int) (Math . random () * adviceList . length) ; 
return adviceList [random] ; 

} 

p\iblic static void main (String[] args) { 

DailyAdviceServer server = new DailyAdviceServer () ; 
server . go ( ) ; 

} 

} 
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Brain Barbell 



How does the server know how to 
communicate with the client? 

The client knows the IP address and port 
number of the server, but how is the server 
able to nnake a Socket connection with the 
client (and make input and output streams)? 

Think about how / when / where the server 
gets knowledge about the client. 



The advke server code on the opposite 
page has a VERY serious llmttation^K looks 
like It c«n handle onKy one client at a timel 



A: 



L- Yes, that's right. It can't accept a request 
from a client until it has finished with the 
current client and started the next iteration of 
the infinite loop (where it sits at the acceptO 
caii until a request comes in, at which time it 
makes a Socket with the new client and starts 
the process over again). 

Let me rephrase the problem: how can 
you make a server that can handle multiple 
clients concurrently??? This would never 
work for a chat server, for Instance. 



A: 



L* Ah, that's simple, really. Use separate 
threads, and give each new client Socket to a 
new thread. We're just about to learn how to 
do that! 



BUUET PaiKTS 



Client and server applications communicate over a Socket 
connection. 

A Socket represents a connection between two applications 
which may (or may not) t>e ainning on two different physical 
machines. 

A client must know the IP address (or domain name) and 
TCP port number of the server application. 

A TCP port is a 16-bit unsigned number assigned to a 
specific server application. TCP port numbers allow different 
clients to connect to the same machine but communicate 
with different applications njnning on that machine. 

T]ie port numbers from 0 through 1023 are resen/ed for 
^ell-known sendees' indudfng HTTP, FTP, SMTP, etc 

A client connects to a sen/er by making a Sen/er socket 

Socket a = new Sockat (^127 . 0 . 0 . 1" , 4200); 

Once connected, a dient can get input and output streams 
from the socket. These are low-level 'connection' streams. 

sock .gatlnputStxoamO ; 

To read text data from the sen/er, create a BufferedReader^ 
chained to an InputStreamReader, which is chained to the 
input stream from the Socket. 

InputStreamReader is a 'bridge* stream that takes in 
bytes and converts them to text (character) data, ifs used 
primarily to act as the middle chain between the high-level 
BufferedReader and the low-level Socket input stream. 

To write text data to the server, create a PrintWriter chained 
directly to the Sockefs output stream. Call the print() or 
printlnQ methods to send Strings to the server 

Servers use a ServerSocket that waits for client requests on 
a particular port number 

When a Sen/erSocket gets a request, it 'accepts' the request 
by making a Socket connection with the client 
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a simple chat client 

WritihQ a Chat Clieht 

We'll write the Chat client applicadon in uvo stages. First we'll 
make a send-only version that sends messages to the server but 
doesn^t get to read any of the messages from other participants 
(an exdting and mysterious twist to the whole chat room 
concept). 

Then we'll go for the full chat monty and make one that both 
sends aTid receives chat messages. 



Version One: send-only 




Code outline 

public class Sio^leChAtClientA ( 

JTaxtFiald outgoing; 
PrintWritar wxit«r; 
Socket sock; 

public void go() { 

// make gui and registar a listener with the send button 
// call the fletUpNetwor5cingO method 

} 

private void aetUpNetnorking t) ( 

// make a Socket, then make a PrintWriter 

// asaign the PrintWriter to writer instance variable 

} 

public class SendButtonListener implements ActionLiatener { 
public void actionPar£ormed(ActionEvent ev) { 
11 get the text froro the text field and 

// send it to the server using the writer (a PrintWriter) 

} 

} // close SendButtonListener inner class 
} // close outer class 
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Import java.io,*; 
in^jort java.net.*; 
import j avax . swing . * ; 
ing)ort java.awt.*; 
in^ort java . awt. avent. * , 



J., tht strea-* ^J-": 



piablio class Si mpleChatCllentA ( 

JTeittField outgoing; 
PrintWriter writer; 
Socket sock; 

public void go() { 

JFrame frame ^ new JFrame Ludicrously Simple Chat Client") 
JPanel mainPanel = new JPanel(); 
outgoing ^ new JTextField(20) ; 
JButton sendButton = new JButton ("^^ Send") ; 
sendButton. addActionListener (new SeLndButtonLiatener () ) 
ma inPanel. add (outgoing) ; 
mainPanel. add (sendButton) ; 

frame . getContentPane ( ) . add (BorderLayout . CENTER ; mainPanel ) 
setOpNetKorkingO ; 
frame . setSlze (400 , 500) ; 
frame.fletVisible(true) ; 
} // close go ^ttt ujihj \oCa\\^^ 

private void aetOpNetworking () { ^tt^tr on ^ l- 

try { ^ ^thMst 

sock = new Socket ("127 , 0 . 0 . 1" , 5000); 
writer = new PrintWriter (sock ,getOu^utStream() ) 
System. out. println (^networking establiahad") ; 
) catch (lOExcept ion ex) { 
ex.printStackTrace () ; 

) 

) II close setUpNetworking 



Vscve* W 



public class SendButtonListener impleiaants ActionListener ( 



public void actionPerformed (ActionEvont ev) 
try { 

writer .println (outgoing. getText() ) ; 
writer .nush 0 ; 



} 



) 



catch (Exception ex) { 
ex . prints tackTrace ( ) j 



outgoing, setText (""'") ; 
outgoing , requeatFocus ( ) 



> // close SendButtonListener inner class 

publia atatic void inaln(3tringf ] arge) { 
Eiew Sin^laChatCliantAO .go() ; 

} 

} // close oucer class 



( 



mpu-t rbre^w -from th^ Sodkrtj io 
\i\\tf\V4ty wc do a PrmtInO, it Jo^i 
ovcv t^»c y^itwork to t^ie scv-v^*-/ 



If you wwll to try fhta now^ typ«i^ 
llMdy4»«lo» chat Mnrvr coife 
listed at til* and of thio dioptof 
^Irot, start tho sarver In one formi 



rmliw^'' 
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improving the chat client 



Version Two: send 
and receive 




r^c^o^t display drc^ uniil iht 



The Server s^ds a mcii^gc io dll 
<tlich£ paHidipjh^, ^5 soon i))c 

dWt appear in tKc ir^oti,i^ 



IK^-Oin'm^ 

messages 




Big Question: HOIVdo you get messages from the server? 

Should be easy; when you set up the networking ooake an input stream as well 
(probably a BufferedReader). Then read messages using readLine(), 

Bigger Question: WHEN do you get messages from the server? 

Think about that. What are the options? 

^ Option One; Poll the server every 20 seconds 

Ptx>s; Well, it's do-able 

Com: How does the server know what you*ve seen and what you haven't? The server 
would have to store the messages, rather thzm just doing a distribute-and-forget each time 
it gets one. And why 20 seconds? A delay like this affects usability, but as you reduce the 
delay, you risk hitting your server needlessly. Inefficient. 

^ Option Two: Read something In from the server each time the user 
sends a message. 

Pros: Do-able, very easy 

Cons: Stupid, Why choose such an arbitrary time to check for messages? What if a user is 
a lurker and doesn't send anything? 

^ Option Three: Read messages as soon as they're sent from the server 

Pros: Most efficient, best usability 

Cons: How do you do you do two things at the same time? Where would you put this code? 
You'd need a loop somewhere that was always waiting to read from the server. But where 
would that go? Once you launch the GUI, nothing happens until an event is fired by a GUI 
component 
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^ In Java you really CM 
waflc and chew giun at 
die same time. 



You know by now that we're 
going with option three. 

We want something to run continuously* 
checking for messages from the server, 
but without intetrupiing the user's ability to 
interact with the GUI! So while the user is 
happily typing new messages or scrolling 
through the incoming messages, we 
want something behind the scenes to keep 
reading in new input from the server. 

That means we finally need a new thread. 
A new, separate stack 

We want everything we did in the Send- 
Only version (version one) to work the 
same way while a new process runs along 
side that reads information from the 
server and displays it in the incoming text 
area. 

Well, not quite. Unless you have multiple 
processors on your computer, each new 
Java thread is not actually a separate 
process running on die OS. But it aJmost 
feels zs though it is. 



Multithreading in Java 

Java has multiple threading built right 
into the febric of the language. And it's a 
snap to make a new thread of execution: 

Thread t = new Thread () ; 
t.startO ; 

That*s it. By creating a new Thread objeciy 
you've launched a separate thread of 
execution^ with its very own call stack. 

Except for one prohlejru 

That thread doesn't actually dloanything» 
so the thread "dies*' virtually the instant 
it s bom. When a thread dies, its new 
stack disappears again. End of story. 

So we're missing one key component — 
the thread's job. In other words, we need 
the code thai you want to have run by a 
separate thread. 

Multiple threading in Java means we 
have to look at both the thread and the job 
that's run by the thread. And weNl also 
have to look at the Thread class in the 
java.lang package. (Remember, ja^'a.lang 
is the package you get imported for 
free, implicidy and it*s where the classes 
most fundamental to the language live, 
including String and System.) 
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A rfired is a separate 
'lliTcad of execution'. 
In other words, a 
separate call stact. 

A Thread is a Java 
class that represents 
a thJ'ead. 

To make a thread, 
make a Thi'ead. 



threads and Thread 



Java has multiple threads but only 
om Thread class 

We cari talk about ihreadwih a lower-case 't' and Thread 
mih a capital T'. Wlien you see thread, we're talking 
about a separate tJiread of execution. In other words, 
a separate call stack. When you see Thread, think of 
the Java naming convention. Wliat, injava, starts with a 
capital letter? Classes and interfaces. In this case, Thread 
is a class in the Java. lang package. A Thread object 
represents a thread of execution; youMl create an instance of 
class Thread each rime you want to stan up a new thread 
of execution. 



thread 



Thread 





main thread another thread 

started by the code 

A thread (lower-case "i') is a separate thread of execudon. 
That means a separate call stack. Every Java application 
starts up a main thread — the thread that puts tlie 
mainO method on the bottom of the stack. The JVM 
is responsible for starting the main thread (and otlier 
threads, as it chooses, including the garbage collecdon 
thread). As a programmer you can write code to sLart 
other threads of your own. 




java.lang.Thread 
class 

Thread (capital T') is a class that 
represents a thread of execution. 
It has methods for starting a 
ihreadjoining one thread with 
another, and putting a thread to 
sleep. (It has more methods; these 
are just the crucial ones we need 
to use now). 
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What does it mean to liave more tlia»i 
ohe call stacic? 

With more than one call stack, you get the appearance of having 
multiple things happen at the same time. Tn reaJity, only a true 
multiprocessor system can actually do more than one thing at a 
dme, but with Java threads^ it can appear \h^i youVe doing several 
things simultaneously. In other words, execution can move back 
and forth between stacks so rapidly that you feel as though all stacks 
are executing at the same time. Remember, Java is just a process 
running on your underlying OS. So iirst, Java tiseljhzs to be *the 
currendy executing process* on the OS. But once Java gets its 
turn to execute, exactly whatiot^ the JVM run? Which bytecodes 
execute? Whatever is on the top of the currendy-running stackl 
And in 100 milhseconds, the currendy executing code might switch 
to a different method on a different stack. 

One of the things a thread must do is keep track of which statement 
(of which method) is currendy executing on the thread's stack. 

It might look something Uke this: 

^ The JVM calls the maln() method, 

public static void main (String [1 arga) { 

main thread 

} 




mainO starts a new thread. The main 
thread is temporarily frozen while the new 
thread starts running. 



Runnable r = now MyThreadJob ( ) ; 



Thread t = new Thread (r) 
t. start 0 ; 
Dog d = new Dog() ; 



y^-'li Im^ ^«ha{ 




main thread 



user throad A 



o 



The JVM switches between the new 
thread (user thread A) and the original 
main thread, until both threods complete. 



(X>9() 




main thread 



user thread A 
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How to launch a new thread: 



O Make a Runnable object (the thread's job) 

Runnable threadJob = n^w MyRunnable ( ) ; 

Runnable is on interface you'll learn about on the next page. 
You'll write a class that implements the Runnable interface, 
and that class is where you'll define the work that a thread 
will perform. In other words, the method that will be run 
from the thread's new call stack. 



Q Make a Thread object (the worker) and 
give it a Runnable (the job) 

Thread myThread = new Thread (threadJcb) ; 

Pass the new Runnable object to the Thread constructor. 
This tells the new Thread object which method to put on 
the bottom of the new stack— the Runnable's run() method. 



Q Start the Thread 

myThread . start ( ) ; 

Nothing happens until you call the Thread's 
startO method. That's when you go from 
having just a Thread ins-fance to having a new 
thread of execution. When the new thread 
starts up, it takes the Runnable object's 
runQ method and puts it on the bottom of 
the new thread's Stack. 
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Every Thread needs a job to do. 

A method to put on the new thread stack. 





Bmwiable is to a 
Thread what a job is to 
a worker. A Rimnable 
is-flie jot aAreail is 
supposed to rim. 

A Ruitnable Kolds Ae 
mefliod -diat goes on 
fte bottom of Ae new 
Aread's Stack- nm(). 



A Thread object needs a job. Ajob the thread will run when the 
thread is staned. That job is actually the first method that goes on t'r^d o^'i 

the new thread's stack, and it must always be a method that looks , , . i^Jratt ^ T Wr, '^'t'* ^'^ 

like this: 

public void run 0 ( +>>t •"C^** ^jSN-^ 

// code that will be run by the new thread -i^^^^" Vwt »^ 



How does the thread know which method to put at the bottom of 
the stack? Because Rimnable defines a contract. Because Runnable 
is an interface. A tliread's job can be defined in any class that 
implements the Runnable interface. Tlie thread cares only that you 
pass the Thread constructor an object of a class that implements 
Runnable. 

When you pass a Rimnable lo a Thread constructor, you're really 
just giving the Thread a way to gel lo a run{) method. You're giving 
the Thread its job to do. 
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To make a Job for your thread. 
impleivieHt the Runnable interface 



public clASB MyRunnable 



piibllc void ^ui^HH ^^--^ 
public void go 0 { 



fx^hllC void (wl^K 
, , U supposed to ^u.. 



public void do^4ore() { 

Sya torn. out. println (^^ top o' the stack") 



class ThraadTaatar { 



public static void main (String [] args) ( 



new 



Runnable threadJob 
Thread myThread = ] 

myThread . start () ; ^ 



System, out .prln tin ("back in main''); 



Pass the y>e* , thruo 




myThre od.stQrtf 
mainQ 
main thread 




new thread 




Brain Barbell 



What do you think the output will be \f you run the 
ThreadTester class? (we'll find out In a few pages) 
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The three states of a new thread 



Thread t = new Thread (r) 
NEW 




t . start ( ) ; 



get started '' 



Thread t = new Thread (r) ; 

A Thread instance has been 
created but not started. 
In other words, diere is a 
Thread object, but no thread 
of execution. 



RUNNABLE 




"fift good to y>/" 



t . start ( ) ; 

When you start the thread, it 
moves into the runnable state. 
This means the thread is ready 
to run and just waiting for its 
Big Chance to be selected for 
execution. At this point, there is 
a new call stack for this thread. 



Selected to run 




This is the state all threads lust 
afterl To be The Chosen One, 
The Currently Running Thread. 
Only the JVM thread scheduler 
can make that decision. You 
can sometimes influence that 
decision, but you cannot force a 
thread to move from runnable 
to running. In the running 
state, a thread (and ONLY this 
thread) has an active call stack, 
and the method on the top of 
the stack is execadng. 



But there's more. Once the thread becomes 
runnable, it can move back and forth between 
runnable, running, and an additional state: 
temporarily not runnable (also known as 'blocked'). 
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thread states 



Typical runnable/running loop 



RUNNABLE 



RUNNING 



Typically, a thread moves back and 
forth between ruanable and running, 
as the JVM thread scheduler selects a 
thread to run and then kicks it back 
GUI so another thread gets a chance. 





Sent back to runnable 
so another thread can 
have a chonce 




A thread can be made 
temporarily not-runnable 



Tlie tliread scheduler can move a 
running thread into a blocked state, 
for a variety of reasons. For example, 
the tiiread might be executing code 
to read from a Socket input stream, 
but there isn't any data to read. The 
scheduler will move the thread out 
of the running state until something 
becomes available. Or the executing 
code might have told the thread to 
put itself to sleep (sleepO). Or the 
thread might be waiting because it 
tried to call a method on an object, 
and that object was 'locked'. In that 
case, the thread can*t continue until 
the object's lock is freed by the thread 
that has it. 

All of those conditions (and more) 
cause a thread to become temporarily 
not-runnable. 
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RUNNABLE 



RUNNING 





waiting (or d^ia to kc available on i^t st*^am> 
waiting for an objedt*i lo^k .. 
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The Thread Scheduler 



The thread scheduler makes all the decisions about 
who moves from runnable to rumning, and about when 
(and under what circumstances) a thread leaves the 
running state. The scheduler decides who runs, and for 
how long, and where the threads go when the scheduler 
decides to kick them out of the cuxrently-nmning state. 

You can't control the scheduler There is no API for 
calling methods on the scheduler. Most importandy, 
there are no guarantees about scheduling! (There are a 
few ^z/tno^^guarantees, but even those are a litde fu2zy.) 

The bottom line is this: do not base your program*s 
correctness on ihe scheduler working in a parUadar way! 
The scheduler implementations are different for 
different JVM 's, and even nmning the same program 
on the same machine can give you different results. 
One of the worst mistakes new Java programmers 
make is to test their multi-threaded program on a 
single machine, and assume the thread scheduler wUl 
alv/ays work that way, regardless of where the program 
runs. 

So what does this mean for write-once-run^anywhere? 
It means that to write platform-independentjava code, 
your multi-threaded program must work no matter how 
the thread scheduler behaves. That means that you can*t 
be dependent on, for example, the scheduler making 
sure all the threads take nice, perfectly fair and equal 
turns at the running state. Although highly unlikely 
today, your program might end up running on a JVM 
with a scheduler that says, "OK thread five, you're up, 
and as far as Tm concerned, you can stay here untU 
youVe done, when your run() method completes," 

The secret to almost everything is skep. That's 
right, sleep. Putting a thread to sleeps even for a few 
milliseconds, forces the currendy-ruruaing thread to 
leave the running state^ thus giving another thread a 
chance to run. The thread's sleep() method does come 
with guarantee; a sleeping thread will no^ become 
the currently-running thread before the the length of 
its sleep time has expired> For example, if you tell your 
thread to sleep for two seconds (2,000 milliseconds), 
that thread can never become the running thread again 
imriJ sometime after ^ht two seconds have passed. 



Number four, you've hod 
enough time. Back to runnob/e. 
Number two, looks like you're upl 

Oh, now ft looks likeyouVe gonno have 
to sleep. Number five, come take his 
place. Number two, you're still 
sleeping... 




TkeAread 
scheduler Piakes all 
tlie decisions about 
^0 runs and \^o 
doesn't. He usually 
makes -die flireads take 
turns, nicely. But 
ihere's no guarantee 
about Aat. He utigk 
let one fkread run 
to its Kearf S content 
\\tole Ae odier 
threads 'starve'. 
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An example of how unpredictable the 
scheduler can be... 



Running this code on one machine: 

pi^lic clasa MyRurmable iioplamants Ruzinable ( 
public void run () { 

go() ; 

) 

public void go() { 
doMora ( > ; 

) 

public void doMorfl 0 { 

System, out .println ("top o' the stack'') ; 

) 



Produced this output: 



I F\\& Eerii Windot^ Help Pldt^le 



class Thr^adTeatDrive ( 

public static void main (String[] args) { 

Runnable threadiJob = naw MyRunnabla () ; 
Thread myThread = new Thread fthraadJob) 

myThread . start ( ) ; 

System. out. println (^^bacX in main"); 



" j^va Thr eadTe s tDr i ve 
back in main 
top o' the stack 

a a T ]-j r a d T s c D r :. --j 
top o' the stack 
back in main 

java ThreadTes tDrxve 
top o' the stack 
back in main 
■-. java ThreadTeshDrive 
top o' the stack 
back in main 
.■ java TfireadTes uDri ve 
top o' the stack 
back in main 
: j a vo T h r ^- a d T (5 s t D :■: j. \^ 
top o' the stack 
back in main 
, Java ThreadTes tDrxve 
back in main 
top o' the stack 
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How did we end up with different results? 



Sometimes it runs iilce this: 



maInO starts the 
new thread 




main thread 



The scheduler sends 
the main thread out 
of running and back 
to runnable, so that 
the new thread can 
run. 



The scheduler lets 
the new thread 
run b completion, 
printing out lop o' 
thestadc" 




main thread 



new thread 



The new thread goes 
away, because its runO 
completed. The main 
thread once again 
becomes the running 
thread, and prints 'back 
In mala' 



main thread 



time 



And sometimes it runs like this: 



mainO starts thB 
new thread 



stor 




main thread 



The scheduler sends The scheduler lets the 



the main thread out 
of mnning and back 
tomnnable.sofrial 
the new thread can 
run. 



new thread run for a 
little while, not long 
enough for themnO 
method to complete. 




main thread 



new thread 



The scheduler 
sends the new 
thread back to 
runnable. 



new thread 



The scheduler 
selects the main 
thread to be the 
Ajnning thread 
again. Main prints 
out 'back In main- 




main thread 



The new thread returns 
to the mnning stale 
and prints out "top o' 
the slack". 




new thread 



time 
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Mve seen examples that don't use a separate 
Runnable Implementation, but Instead just make a 
subdass of Thread and override the Thread's runQ 
method. That way, you call the Thread's no-arg 
constructor when you make the new thread; 

Thread t = newThreadO; // no Runnable 



A: 



Yes, that Is another way of making your own 
thread, but think about it from an OO perspective. 
What's the purpose of subclassing? Remember that 
we're talking about two different things here— the 
Thread and the thread's job. From an 00 view, those 
two are very separate activities, and belong in separate 
ciasses.The oniy time you want to subciass/extend 
the Thread class, Is if you are making a new and more 
specific type of Thread, in other words, if you think of 
the Thread as the worker, don't extend the Thread ciass 
unless you need more specific ivor/cer behaviors. But if 
all you need is a new job to be run by a Thread/wofker, 
then implement Runnable In a separate, /ob-specific 
(not wo^^cef-speciflc) ciass. 

This is a design Issue and not a performance or 
language Issue. It's perfectly legal to subclass Thread 
and override the runO method, but It's rarely a good 
idea. 

Can you reuse a Thread object? Can you give It 
a new Job to do and then restart It by calling startO 
again? 



No. Once a thread's run() method has completed, 
the thread can never be restartedJn fact,atthat 
point the thread moves into a state we haven't talked 
about— de«2d. In the dead state, the thread has 
finished Its run() method and can never be restarted 
The Thread object might still be on the heap, as a 
living object that you can cati other methods on (if 
appropriate), but the Thread object has permanently 
lost its'threadness'. In other words, there is no longera 
separate call stack, and the Thread object Is no longer 
a thread. It's Just an object, at that point, like all other 
objects. 

But, there are design patterns for making a pool of 
threads that you can keep using to perform different 
jobs. But you don't do it by restartingO a dead thread. 



BUILET POIHIS^ 



A thread v^th a lower-case T is a separate thread of 
execution in Java. 

Every thread In Java has its own call stack, 

A Thread with a capital T Is the java.fang.Thread 
dass. A Thread object represents a thread of 
execution. 

A Thread needs a job to do. A Thread's job is an 
instance of something that Implements the Runnable 
interface. 

The Runnable Interface has just a single method, mn(). 
This is the method that goes on the bottom of the new 
call stack. In other words, it is the first method to ojn In 
the new thread. 

To launch a new thread, you need a Runnable to pass 
to the Thread's constaictor 

A thread is !n the NEW state when you have 
instantiated a Thread object but have not yet called 
start(). 

When you start a thread {by calling the Thread object's 
startQ method), a new stack is seated, with the 
Runnable's runQ mettiod on the bottom of the stack. 
The thread is now in the RUNNABLE state, waiting to 
be chosen to run, 

A thread is said to be RUNNING when the JVM's 
thread scheduler has selected it to be the cun'ently- 
njnning thread. On a single-processor machine, there 
car\ be only one cuniently-funning thread. 

Sometimes a thread can be moved from the RUNNING 
state to a BLOCKED {temporarjiy non-mnnable) state. 
A thread might be blocked because it's waiting for data 
from a stream, or because It has gone to sleep, or 
because it is waiting for an objecfs lock. 

Thread scheduling Is not guaranteed to work in any 
particular way, so you cannot be certain that threads 
will take turns nicely. You can help influence turn-taking 
by putting your threads to sleep periodically 
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FuttlHg a thread to sleep 




One of the best ways to help your threads take uims is 
to put ihem to sleep periodically. All you need to do 
is call the static sleepO method, passing it the sleep 
duration^ in milliseconds. 

For example: 

Thread, sleep (2000) ; 
will knock a thread out of tJ:\e mnning stale, and 
keep it out of the runnable state for two seconds. 
The thread can become the running thread 
I again untiJ after at least t^vo seconds have passed. 

i A bit unfortunately, the sleep method throws an 
f InterrupiedException, a checked exception, so all 
calls to sleep must be wrapped in a try/ catch (or 
declared). So a sleep call really looks like this: 

try ( 

Thread. sleep (2000) ; 
catch (InterruptedException ex) { 
ex. prints tackTrace (] ; 



Your thread will probably n^erhe interrupted from 
sleep; the exception is in the API to support a thread 
communication mechanism that almost nobody uses in 
the Real World. But, you still have to obey die handle 
or declare law, so you need to get used to wrapping your 
sleepO calls in a try/catch. 

Now you know that your thread won't wake up before ihe 
specified duration, but is it possible Uiat it will wake up 
some time afterihe 'timer' has expired? Yes and no. It 
doesn't matter, really, because when the thread wakes 
up, it always goes bach to the nmnable state/ The thread 
won*t automatically wake up at the designated time and 
become the currently-running thread. When a tliread 
wakes up, die thread is once again at the mercy of 
the thread scheduler. Now, for applications that don't 
require perfect timing, and that have only a few threads, 
it might appear as though the thread wakes up and 
resimies running right on schedule (say, after the 2000 
milliseconds). But don't bet your program on it. 



Put your -diPeaH to sleep 
if you want to be sure 
fkt odier -fiiTeads get a 
cKance to run. 

\Aen -die ftrea(3 wakes 
up. tt always goes back 
to die runnable stafB 
and waits for Ae -diread 
sckeduler to choose it 
to run again. 
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Using sleep to make our program 
more predictable. 

Remember our earlier example that kept giving us different 
results each time we ran it? Look, back and study the code 
and the sample output Sometimes main had to wait until the 
new thread finished (and printed "top o' the stack**), while 
other times the new thread would be sent back to rurmable 
before it finished, allowing the main thread to come back 
in and print out ''back in main*'. How can we fix that? Stop 
for a moment and answer this question: ''Where can you put 
a sleep () call, to make sure thai "back in main" always prints 
before ^'top o' the stack"? 

WeMl wait while you work out an answer (there's more than 
one answer that wouJd work). 

Figure it out? 

public class MyRunnable implements Ruzmable ( 

public void run () { 
goO; 



public void 



I Re Edk Window Help SnoozeBunon 



^ava ThreadTes tDrive 
back in main 
top o' the stack 
,; ^ava ThreadTes tDrive 
back in main 
top o' the stack 
. java ThreadTes tDrive 
back in main 
top o' the stack 
■ ^ava ThreadTes tDrive 
back in main 
top o' the stack 

java ThreadTG s tDrive 
back in raaxn 
top o' the stack 




public void doMoreO ( 

System, out. println ("top o' tha stack"); 

} 



class Thzre&dTestDrive ( 

public static void main (String [] args) ( 
Runnable the Job » new MyRuniiabla() ; 
Thread t = new Thread (tha Job) ; 
t. start 0 ; 

System. out .println( "back in main") ; 

) 

> 
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Making and starting fivotlireads 

Threads have names. You can give your threads a name of 
your choosing, or you can accept their default names. But the 
cool thing about names is that you can use them to tell which 
thread is running. The following example starts two threads. 
Each thread has the same job: run in a loop, printing the 
currently-running thread's name with each iteration. 



public class RunThreads Implamen^ Runnable ( 

public static void main (String [J arga) ( A(^^t<^^^^ 
RunThraadB runnar » new RanThrdada ( ) ; 

Thread alpha ^ new Thread (runner) ; <: im i l i. j mi 

Thread beta = new Thread (runner) ; ^r^^ .T" ^^l^fj^'^^''^ ^^^^^^'^ ^the 

alpha. aetName ("Alpha thread") ;^ f 7 J o""" l . '^T '-(^^^^ 

beta. setNaine (-Beta thread'');^ Ku.r^Wc a ftw pa^cs). 

alpha. atartO ; f^^^e iKc tKvcads. 

beta.startO; ^ Sb>r| th^c<»ck 

public void run 0 { hr.^ \b^ ^ 

for (int i = 0; i < 25; i++) { ^ ^ 

String threadName ■ Thread . currentThread (), getMame () ; 
Syat:aiii.out-println(threadNaiM + i» running") ; 

} 



} 



I Re Edrt 



WifWow Help Certtaorr 



What will happen? 



Part o( tK< output when 
tKc loop iicv-a-Ui 2*5 



Will the threads take turns? WilJ you see the thread names 
alternating? How often vAU they switch? With each iteration? 
After five iterations? 

You already know the answer: we don't knmv! It s up to the 
scheduler. And on your OS> with your particular JVM, on 
your (HPU, you might get very different results. 

Running under OSX 10.2 (Jaguar), with five or fewer 
iterations, the Alpha thread nms to completion^ then 
the Beu thread runs to completion. Very consistent. Not 
guaranteed, but very consistent. 

But when you up the loop to 25 or more iterations, things 
start to wobble. The Alpha thread might not get to complete 
all 25 iterations before the scheduler sends it back to 
runnable to let the Beu thread have a chance. 



Alpha thread 
Alpha thread 
Alpha thread 
Beta thread 
Alpha thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Beta thread 
Alpha thread 



is running 
is running 
is running 
is running 

is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
is running 
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aren't threads wonderful? 




Um. yes. There IS a dark side. 
Threads can lead to cohcurrency 'Issues' 

Concurrency issues lead to race conditions. Race conditions 
lead to data corruption. Data corruption leads to fear... you 
know the rest. 

It all comes down to one potentially deadly scenario: two or 
more threads have access to a single object's datcu In other 
words, methods executing on two different stacks are botii 
calHng, say, getters or setters on a single object on the heap. 

It*s a whole 'left-hand-doesn't-know-what-the-right-hand- 
is-doing' thing. Two threads, without a care in the world, 
humming along executing their methods, each thread 
thinking that he is the OncTrue Thread. The only one 
that matters. After all, when a thread is not nmning, and in 
runnable (or blocked) its esse ntiajly knocked unconscious. 
When it becomes the currently-running thread again, it doesn*t 
know that it ever stopped. 
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Marriage in Trouble, 
Can this couple be saved? 

Next, on a very special DnStevB Show 

[Transcript from episode #42] 
Welcome to thB Dr. Steve show. 



y 



I 



WeVe got a story today thBVs centered around the top two reasons why 
couples split up— finances and sleep. 

Today's troubled pair, Ryan and MoniCEu, share abed and a 
bank account. But not for long If we can't find a solution. The 
problem? The classic "two people— one bank accoimt" thing. 

Here's how Monica deaorlbed It to me: 

"Ryan and I agreed that neither of us will overdraw the checking account. 
So the procedure is, whoever wants to withdraw money znu^t check the 
balance in the accoimt befbre making the withdrawal. It all seemed so 
simple. But suddenly we're bouncing checks and getting hit with overdraft 
i^esl 

I thought it wasn't possible, I thought our procedure was safe. But then 
this happened: 

Ryan needed $50, so he checked the balance in the account, 
and saw that it was $ 100. No problem. So, he plans to 
withdraw the money. But first ha fblls asleep ! 

And that's where I come in, while Ryan's still asleep, and 
now J want to withdraw $100. 1 check the balance, and 
it's $100 (because Ryan*s stUl asleep and hasn't yet made 
his withdrawal), so I think, no problem. So I make the 
withdrawal, and again no problem But then Ryan wakes up, 
completes ills withdrawal, and we're suddenly overdrawn I He didn't 
even know that he feU asleep, so he Just went ahead and completed his 
transaction without checking the balance again. You^7e got to help us Dr. 
Stevel" 

Is there a solution? Are they doomed? We caji't stop Ryan from felling 
asleep, but can we make sure that Monica can't get her hands on the bank 
atxjount imtil after he wakes up? 

Take a moment and think ahout that while we go to a commercial break. 
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The KyaH and MoHica problem, in code 

The foUowing example shows what can happen when tm 
threads (Ryan and Monica) share a iin^Z? object (the bank 
account). 

The code has two classes, BankAccount, and 
MonicaAndRyanJob- The MonicaAndRyanJob class 
implements Rimnable, and represents the behavior that Ryan 
and Monica both have — checking the balance and making 
withdrawals. But of course, each thread fells asleep in between 
checking the balance and actually making the withdrawal. 

The MonicaAndRyanJob class has an instance variable of type 
BankAccount., that represents their shared account 

The code works like this: 



Make one instance of RyanAndMonicaJob. 

The ftyonAndMonicaJob class is the Runnable (the job to do), 
and s/nce both Monica and ftyon do the same thing (check 
balance and w/thdraw money), we need only one instance, 

RyanAndMonicaJob the Job = new RyanAndHoaicaiTob () 



Make two threads wrth the same Runnable 

(the RyanAndMonicaJob instance) 

Thread one = naw Thread (theJ'c>b) ; 
Thread two = new Thread (thaJob) ; 

Name and start the threads 

one . aetNama (^Ryaii") ; 
two . setNaioe ( "Monica" ) ; 
one . start 0 ; 
two. s tart 0 ; 

Watch both threads execute the runQ method 

(check the balance and make a withdrawal) 

One thread represents Ryan, the other represents Monica. 
Both threads continiially check the balance and then make a 
withdrawal, but only if ft's safe! 
if (account , getBalance () >= amount) ( 

try { 

Thread. sleep (500) ; 

) catch (InterruptodException ex) {ex.printStacJcTrace () ; 

} 




RyanAndMonlcaJob 



BankAccount account 



runO 

makeWithdrawalQ 



In the run() method, do 
exactly what Ryan and 
Monica would do — check 
the balance and, if 
there's enough money, 
make the withdrawal. 

This should protect 
against overdrawing the 
account- 
Except... Ryan and 
IMonica always fall 
asleep a^^r they 
check the balance but 
before they finish the 
withdrawal. 
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fbe Ryan and Monica example 



class BankAccount { 

private int balance = 100; ^ 



ptiblic int getBalanceO { 
return balance; 

} 

pxibiic void withdraw (int amount) 
balance = balance - amount; 

} 



f 



public class RyanAndMonicaJob iii5>lements Runnable { 
private BankAccount account = new BankAccount ( ) ; 



piablic static void main (String [] args) { 

RyanAndMonicaJob the Job = new RyanAndMonica Job { ) 
Thread one = new Thread (the Job) 
Thread two = new Thread (the Job) 
one . setName ("^Ryan") ; 
two. setName (''Monica") ; 
one. start 0 ; 
two. start 0 ; 



Sss. 



} 



public void run () { 
for (int X = 0; X < 10; x++) 
inakeWithdrawl(lO) ; 
if (account. getBalanceO < 0) { 
System . out . println ( ^'Overdrawn !" ) 



{ 



L .ake a V.Wvd-al ^^i^ e^t^ ^ 
La\, 6V.etk. tHe baUte o.^e a^- 



} 



{ 



e.o4. ^ *»«^ ^^"^ ''^ 
the wiiWvaxal, jwl like Ry*" 



private void makeWlthdrawal (int amount) 
if (accoiint.getBalance () amount) { 

System. out. println(Thread.currentThread() .getNiuneO + " 
try { 

System. out. println( Thread. currentThreadO .getNamaO + 

Thread. sleep (500) ; 
} catch (InterruptedException ex) (ex.printStackTrace () ; 
System. out.println (Thread. cur rentThread 0 .getMameO + " 
account. withdraw (amount) ; 

System, out.println (Thread. currentThreadO .getNameO + " 

) 

else { 

System. out.println ("Sorry, not enough for " + Thread. currentThreadO .getName ()) ; 

' ' Itl' ! ^'"^ ^^^'^-^^ - we c.. 

^eewhai. Happening as it vu*,.. ' 
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is about to withdraw") ; 
is going to sleep") ; 

) 

woke up.") ; 

con^letes the withdrawl") ; 



Kyan ana Monica output 



Ho>^ did 



I Rife Edll Wiodow H6(p Vlfia 



Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Monica is about to withdraw 
Monica is going to sleep 
Ryan woke up. 

Ryan completes the withdrawl 
Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up. 

Monica completes the withdrawl 
Monica is about to withdraw 
Monica is going to sleep 
Ryan woke up. 

Ryan completes the withdrawl 
Ryan is about to withdraw 
Ryan is going to sleep 
Monica woke up . 

Monica completes the withdrawl 
Sorry, not enough for Monica 
Sorry, not enough for Monica 
Sorry, not enough for Monica 
Sorry, not enough for Monica 
Sorry, not enough for Monica 
Ryan woke up . 

Ryan completes the withdrawl 
Overdrawn » 

Sorry, not enough for Ryan 
Overdrawn ? 

Sorry, not enough for Ryan 
Overdrawn ! 

Sorry, not enough for Ryan 
Overdrawn! 



The makeWithdrawaiO method 
always checks the balance 
before making a withdrawal, 
but still we overdraw the 
account. 

Here's one scenario: 

Ryan checks the balance, sees that 
there's enough money, and then falls 
asleep. 

Meanwhile, Monica comes in and checks 
the balance. She. too, sees that there's 
enough money. She has no Idea that 
Ryan is going to wake op and comptete a 
withdrawal. 

Monica falls asleep. 

Ryan wakes up and completes his 
wfthdrawaL 

Monica wakes up and completes her 
withdrawal. Big Problem! In between the 
time when she checked the balance and 
made the withdrawal. Ryan woke up and 
pulled money from the account. 

Monica's check of the account was 
not valid, because Ryan had already 
checked and was still in the middle of 
making a withdrawal. 

Monica must be stopped from getting 
into the account until Ryan wakes up and 
finishes his transaction. And vice-versa. 
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They need a lock for account access! 



The lock works like this; 



There's a lock ossociQted with the bonk 
account transaction (checking the balance 
and withdrawing money). There's only 
one key, and it stays with the lock until 
somebody wants to access the account. 




The bank account 
transaction is 
unlocked when 
nobody is using 
the account. 



When Ryan wants to access the bank 
account (to check the bolance and withdraw 
money), he locks the lock and puts the key 
in his pocket. Now nobody else con access 
the account, since the key is gone. 




When Ryan 
wants to access 
the account, he 
secures the lock 
and takes the key. 



Ryan keeps the key in his pocket until he 
finishes the transaction. He has the only 
key, so Monfca con't access the account 
(or the checkbook) until Ryan unlocks the 
account and returns the key. 

Now, even if Ryon falls asleep after he 
checks the bafance, he has a guorontee 
that the balance will be the same when he 
wakes up, because he kept the key while he 
was asleep! 




When Ryan is 
finishedi he 
unlocks the lock 
and returns the 
key. Now the key 
IS available for 
Monica (or Ryan 
again) to access 
the account. 
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We need the makeWithdrawalO method 
to run as owe atomic thing. ||| 

We need to make sure that once a thread enters the 
makeWithdrawalO method, it miisl be allowed to finish the method 
before any other thread can enter. 

In other words, we need to make sure that once a thread has 
checked the account balance, that thread has a guarantee that it can 
wake up and finish the withdrawal befcne any other thread can check ths 
account balance! 

Use the synchronized keyword to modify a method so that only 
one thread at a dme can access it 

That's how you protect the bank account! You don*t put a lock on 
the bank account itself; you lock the method that does the banking 
transaction. That way, one thread gets to complete the whole 
transaction, start to finish, even if that thread ^Is asleep in the 
middle of the method! 

So if you don't lock the back account, then what exactly is locked? Is 
it the metliod? The Runnable object? The thread itself? 

We'll look at that on the next page. In code, though, it*s quite 
simple — -just add the synchronized modifier to your method 
declaration: 




The synchronized 

keyword means that 
a thread needs a key 
in order to access the 
synchronized code. 

To protect your data 
(like the bank account), 
synchronize the 
methods that act on 
that data. 



private llllllimimi^l void makeWithdrawal (int amount) { 

if (account. gatBal&nce () >= amount) { 

SyatADi.ciut .priritln (Thxead. currontThr«ad() .g«tNaxDe () + is about to withdraw"); 

«try ( 
i System. out. pr in tin (Thread. cur rentThr ©ad 0 ,getName() + ^ is going to sleep"); 
' Thread. sleep(500) ; 
^ } catch (InterruptedException ex) (ex.printStackTraoe ( > ; ) 

System, out.println (Thread. ourrentThread 0 .getNamaO + wolca up."); 
account, withdraw (amount) ; 

System, out.prin tin (Thread. currentThread () .getNameO + completes the withdrawl") ; 
} else ( 

System, out. println (^^ Sorry, not enough for + Thread. currentThread () .getName ()) ; 

} 

} 



(l^oit to\- you ^Kyiids-tavvy vt^dori' ycsj tHc tonv^ntioft of uim^ {Mc '^tOrd "aW^i^.* ^CrC docs noi rc(\ui 
the ^\\o\t Jubat<>n»it fBrtbc\t tKm^. TKink f»^Cwtovi, not Einit^n) y«>u h^t* {}t\i word ^ato^'id^ m tHc 

t^iti^i o( threads <^ traftxa^twa- Heyj it'* not OUR ^vtnticm. (-f IV6 wcv*c m dha^r^c, we'd apply 

KeUcYitft^'s Uir^cirtamty Pvin^-iplc to pretty "^uih evcrythtrv^ related to thv^di.) 



510 chapter 15 



networking and threads 



iinq an object's lock 

pRery objeci has a lock. Most of the lime, the 
. is unlocked, and you can ima^ne a xartual 
^sitting it. Object locks come into play 
'onh" when there are synchronized methods, 
^lien an object has one or more synchronized 
Pfaethods, a thread can enter a synchronized 
wiethod only if the thread can get the key to the 
Eject 's lock! 

Tbe locks are not per ynet/wd^ they 
Ke per atjecL Tf an object has two 
^vEtchronized methods, it does not 
iply mean tliat you can't have two 
&ads entering the same method. It 

IS you can*t have two tJireads entering 
f of the s}Tichronized metJiods. 

\k about it, If you have multiple 
iiethods that can potentially act on an 
bject's instance variables, all those methods 
ad to be protected with synchronized. 

be goal of synchronization is to protect 
cridcal data. But remember, you don't lock the 
sita itself, you synchronize the metJiods that 
ress that data. 

avhai happens when a tJiread is cranking 
ihrough its call stack (starting with the nin() 

eediod) and it suddenly hits a synchronized 
ethod? The thread recognizes that it needs 
a key for that object before it can enter the 
joaethod. It looks for the key (this is all handled 
Sby the JVM; tliere's no API in Jax'a for accessing 
object locks), and if the key is available, the 
thread grabs the key and enters the method. 

Jrom that point fonvard, the thread hangs on 
||0 that key like the thread^s life depends on 
XL The thread won't g^ve up the key until it 
completes the synchronized method. So while 
ilthat tliread is holding the key no other threads 
can enter ayiyof that object's synchronized 
metliods, because the one key for tliat object 
won*t be available. 






Every Java object Kas a lock. 
A look has only one Itey. 

Most of -die -time, Ae look is 
imlocled and nobody cares. 

But if an object ks 
synckronized mediods, a 
-ftiread can enter one of fte 
ss^kronized mefiods ONLY 
if the Icey for Ae object's loclt 
is available. In o&er words, 
only if anofier Aread Kasn't 
already grabbed -die one Itey. 
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Tlie dreaded "Lost Update"" problem 

Here's another classic concurrency problem, that comes from the database world. It's 
closely related to the Ryan and Monica story, but well use this example to illustrate a few 
more points. 

The lost update revolves around one process: 
Step 1: Get the balance in the account 

int i = balanced- 
Step 2: Add 1 to that balance 
balance = i + 1; 

The trick to showing this is to force the computer to take two steps to complete the change 
to the balance. In the real world, you'd do this particular move in a single statement: 
balance++ ; 

But by forcing it into two steps, the problem with a non-atomic process will become clear. 
So imagine that rather than the trivial "get the balance and then add 1 to the current 
balance" steps, the two (or more) steps in this method are much more complex, and 
couldn't be done in one statement. 

In the "Lost Update" problem, we have two threads, both trying to increment the balance, 
class TestSync implements Runnable { 



private int balance ; c^q ^w^^^* 

public void run 0 { trt^t^^^"^^ 

for (int i = 0; i < 50; i++) { k ' ^^Lv. ^tev^^'*^ 

increment ( ) ; 

System.out.prin tin ('"balance is 

} 




} 



public void increment () { 
int i = balanced- 
balance = i + 1;4 

} 



) 



public class TestSyncTest { 

pxiblic static void main (String [] args) 
TestSync job = new TestSync () ; 
Thread a = new Thread (job) ; 
Thread b = new Thread (job) ; 

a. start 0 ; 

b. startO ; 

} 

} 
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Let's run this code... 

^ Thread A runs for awhile 

0^ Put the value of balance into variable i. 




Balance is 0» so » is nov^ 0, 

Set the value of balance to the result of i + 1 . 

Now balance Is 1. 

Put the value of balance Into variable i. 
Balance Is 1 . so I is now 1 . 
Set the value of balance to the result of I + 1 , 
Now balance Is 2, 



j|P Thread B runs for awhile 




Put the value of balance into variable L 
Balance is 2, so i is now 2. 
Set the value of balance to the result of i + 1 
Now balance is 3. 

Put the value of balance into variable i. 
Balance is 3, so i is now 3. 

(now thread B is sent back to mnnable, 
before it sets the value of balance to 4] 



Thread A runs again, picking up where it left off 

Put the value of balance into variable 
Balance is 3, so i is now 3. 
Set the value of balance to the result of I + 1 
Now balance Is 4. 

Put the value of balance Into variable 
Balance is 4, so i is now 4. 
Set the value of balance to the result of I + 1 
Now balance is 5, 



Thread B runs ogoin, and picks up exoctly where it left of f I 

0k Set the value of balance to the result of I + 1 . 

' Now balance Is 4. 






VhrcBd A u^dji^d \i io but 
B tame \>AcV and iUpVcd 
'Up o( iVc update A *-ad^ 
as A's v^pdate ncvcv Kapper^ed. 



We lost the last updates 
that Thread A made! 
Thread B had previously 
done a ^read' of the value 
of balance, and when B 
woke up, It Just kept going 
as If it never missed a beat. 
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Make the iHcremeHtO mihod atomic. ^| 
SyhchroHize it! 

Synchronizing the increment() method solves the "Lost 
Update" problem, because it keeps the two steps in the method 
as one unbreakable unit. 



public incremantO { 

int i = balance; 
balance = i + 1 ; 

} 



Once a thread enters 
the method, we have 
to make sure that all 
the steps in the method 
complete (as one 
atomic process) before 
any other thread can 
enter the method. 



Dumb Questipns 



Sounds like it's a good idea to synchronize 
everything Just to be thread-safe. 



A: 



Nope, it's not a good idea. Synchronization doesn't 
come for free. First, a synchrortized method has a certain 
amount of overhead, in other words, when code hits a 
synchronized method, there's going to be a performance hit 
(although typicaiiy, you'd never notice It) whiie the matter of 
"Is the l<ey avaiiabie?''is resoived. 

Second, a synchronized method can slow your program 
down because synchronization restricts concurrency, in 
other words, a synchronized method forces other threads to 
get in line and wait their turn.This might not be a problem 
in your code, but you have to consider it. 

Third and most frightening, synchronized methods can lead 
to deadlocl<l (See page 516.) 

A good rule of thumb is to synchronize only the bare 
minimum that should be synchronized. And in fact, you 
can synchronize at a granularity that's even smaller than 
a method. We don't use it In the book, but you can use the 
synchronized keyword to synchronize at the more fine- 
grained level of one or more statements, rather than at the 
whole-method level. 



public void go() 
doStuff 0 ; 
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Thread A runs for awhile 

Attempt to enter the increment() method. 

The method is synchronized, so get the key for this object 
Put the value of balance into variable i. 
Balance Is 0, so i is now 0. 
Set the value of balance to the result of i + 1 . 
Now balance is 1. 

Return the key (it completed the increment() method). 
Re-enter the increment() method and get the key. 
Put the value of balance into variable i. 
Balance is 1 , so i is now 1 . 

[now thread A is sent back to runnable, but since it has not 
completed the synchronized method, Thread A keeps the key] 



Thread B is selected to run 



Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

The key is not available. 

[now thread B is sent into a 'object lock not available lounge] 



Thread A runs again, picking up where it left off 
0§k (remember, it Still has the key) 




Set the value of balance to the result of i + 1 . 
Now balance is 2. 
Return the key. 

[now thread A is sent back to runnable, but since it 
has completed the incrementQ method, the thread 
does NOT hold on to the key] 



^ Thread B is selected to run 

Attempt to enter the increment() method. The method is 
synchronized, so we need to get the key. 

This time, the key IS available, get the key. 

Put the value of balance into variable i. 

[continues to run...] 
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The deadly side of synchrohizatioH 

Be careful when you use synchronized code, because nothing 
will bring your program to its knees like thread deadlock. 
Thread deadlock happens when you have two threads^ both of 
which are holding a key the other thread wants. There's no way 
out of this scenario, so the two threads will simply sit and wait. 
And wait. And wait- 

If you Ye familiar with databases or other application sen'ers, 
you might recognize the problem; databases often have a 
locking mechanism somewhat like s>nnchronization. But a 
real transaction management system can sometimes deal with 
deadlock. It might assume^ for example, that deadlock might 
have occurred when two transactions are taking too long to 
complete. But unlike Java, the applicadon server can do a 
''transacuon rollback" that returns the state of the rolled-back 
transaction to where it was before the transaction (the atomic 
pan) began. 

Java has no mechanism to handle deadlock. It won't even know 
deadlock occurred. So it's up to you to design carefully. If you 
find yourself writing much multidireaded code, you might 
want to study **Java Threads" by Scott Oaks and Henry Wong 
for design tips on avoiding deadlock. One of the most common 
tips is to pay attention to the order in which your threads are 
started. 



All it takes for 
deadlock are two 
objects and two 
threads. 



t©4 4 



A simple deadlock scenario: 




Thread A enters a 
synchronized method 
of object foQ, and gets 
the key. 



Thread A goes to 
sleep, holding the 
foo key. 



t8 




Thread B enters a 
synchronized method 
of object bar. and gets 
the key 



Thread B tries to enter 
a synchronized method 
0^ of object foo, but can't 
get f/»af key (because 

" A has it). B goes 
to the waiting lounge, 
until the foo key Is 
avallabfe, 8 keeps the 
bar key. 




Thread A wakes up (still 
holding the foo key) 
and tries to enter a 
synchronized method on 
object bar. but can't get 
that key because 8 has 
it. A goes to the waiting 
lounge, until the bar key Is 
available (it never will be!) 

Thread A can't run undl 
it can get the bar key, 
but B is holding the bar 
key and B can't run until It 
gets the foo key that A Is 
holding and... 
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_ BULLET POIinf^P 

■ The static Thread-sleepQ method forces a ttiread to leave the 
running state for at least the duration passed to the sleep method. 
Thread.sleep(200) puts a thread to sleep for 200 milliseconds. 

■ The sleepQ method throws a checked exception (IntemjptedException), 
so all calls to sleepQ nnust be wrapped in a try/catch, or declared. 

■ You can use sieepQ to help make sure all threads get a chance to run, 
although there's no guarantee that when a thread wakes up if II go to the 
end of the mnnable line. It might for example, go right back to the front. 
In most cases, approprlateiy-timed sieepQ calls are all you need to keep 
your threads switching nicely. 

■ You can name a thread using the (yet another surprise) setNameQ 
method. All threads get a default name, but giving them an explidt name 
can help you keep track of threads, especially if you're debugging with 
print statements. 

■ You can have serious problems with threads if two or more threads have 
access to the same object on the heap. 

■ Two or more threads accessing the same object can lead to data 
comjption rf one thread, for example, leaves the mnning state while stfll 
in the middle of manipulating an object's critical state. 

■ To make your objects thread-safe, decide which statements shoutd be 
treated as one atomic process. In other words, decide which methods 
must run to completion before another thread enters the same method 
on the same object, 

■ Use the keyword synchronized to modify a method declaration, 
when you want to prevent two threads from entering that method. 

■ Every object has a single lock, with a single key for that lock- Most of the 
time we don't care about that lock; locks come into piay only when an 
object has synchronized methods. 

■ When a thread attempts to enter a synchronized method, the thread 
must get the key for the object (the object whose method the thread 
Is trying to run}. If the key Is not available (because another thread 
already has it), the thread goes into a kind of waiting lounge, until the key 
becomes available. 

■ Even if an object has more than one synchronized method, there is still 
only one key. Once any thread has entered a synchronized method on 
that object, no thread can enter any other synchronized method on the 
same object This restriction lets you protect your data by synchronizing 
any method that manipulates the data. 
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New ahd improved SImpleChatClient 



Way back near the beginning of this chapter, we buih the SimpleChatCUent that could send 
outgoing messages to the server but couldn't receive anything. Remember? That's how we 
got onto this whole thread topic in the first place, because we needed a way to do two things 
at once: send messages to the server (interacting with the GUI) while simultaneously reading 
incoming messages from the server, displaying them in the scrolling text area. 



import java.io,*; 
iiaport java.net.*; 
iir5>ort java.util.*; 
import javax. swing,*; 
import j ava . awt . * ; 
import j ava . awt . event . * ; 

pijblic class SinpleChatClient { 

JTextArea incoming; 
JTextField outgoing; 
BufferedReader reader; 
PrintWriter writer; 
Socket sock; 



O^t not yci-. 



public static void main (String [] args) { 

Sin^leChatClient client = new Sin^leChatClient () 
client. go () ; 

} 

pxjblic void go() ( 



JFrame frame = new JFrame (''Ludicrously Sin^jle Chat Client"); 

jpanel mainPanel = new JPanelO; 

incoming = new JTextArea (15,50) ; 

incoming . setLineWrap (true) ; 

incoming. setWrapStyleWord( true) ; 

incoming. setKdi table (false) ; 

JScrollPane qScroller = new JScrollPane (incoming) ; 

qScroller . setVerticalScrollBarPolicy (ScrollPaneConstants . VERTICAL_SCROLIiBAR_ALWAYS) ; 
qScroller . setHorizontalScrollBarPolicy (ScrollPsmeConstants . HORIZONTAL_SCR0LLBAR_NEVER) ; 
outgoing = new JTextField (20) ; 
JButton sendButton = new JButton("Send") ; 
sendButton . addActionListener (new SendButtonListener ( ) ) 
mainPanel . add (qScroller) ; 
mainPanel. add (outgoing) ; 
mainPanel. add (sendButton) ; 
setUpNetworkingO ; 



frame . ge tContentPane ( ) . add (BorderLayou t . CENTER , mainPanel ) 
frame.setSize(400,500) ; 
frame . setVisible (true) ; 



the K^^^\>\t (job; i;^ l^, 
«i»-<>llih5 text avea. 



) /V close go 
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private void setUpNetwor)c±ng () { 



} // 



try { 

sock = new Socket ("127 . 0 . 0 . 1" , 5000); 

Inputs treaisRe&der atreamReadar ^ new InputStreamReader (sock.getlnputStreftm () ) 
reader = new B\i££eredReader (streamReader) ; 
writer = new Pr in tWr iter (sock .getOutpi>tStreaiii() ) 
System. out. printin (""networJcing established") 
) catch (lOException ex) { Wc^e 7",,^ ^t^^^ ai>rt-i*] - 

ex.printStackTrace 0 ; M ^^^T t t "to 

close setUpNecworklng fcvt no^ '^'^ ^ 3*1^' 5^ 

tv^at u 



public class SendButtonliistener in^lementa ActionU-stenar { 



public void actionPerformed (ActionJBvent ev) { 
try { 

writer.println (outgoing. get Text () ) ; 



) 



wri ter. flush 0 ; 

} catch (Exception ex) ( 
ex.printStackTraceO ; 

} 

outgoing. setText("") ; 
outgoing. requastFocus () ; 



^on^^^ ^ the -text (i^ii £^ ^ 



) // close inner class 



alio olua InooBln^itmdM ii^lflnuts Runubltt { 

>lle void ruiiO ( 
Staring mi 
try f 



while ((aasflagtt b £«adAr.readLine() ) null] ( 

J // close while 
} catch (£ico«ptlm «x) (M.prdJEitStadJG^Ri»jOs() ;} 

"7/ close njn 



) II close outer class 
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Cade 



import java.io.*; 
iii5>ort java.net,*; 
inport java -util . * ; 



The really really simple Chat Server 

You can use this server code for both versions of the Chat Client Every possible 
disclaimer ever disclaimed is in effect here. To keep the code stripped dovm to the 
bare essentials, we took out a lot of parts that you'd need lo make this a real sen/er. 
In other words, it works, but there are at least a hundred ways to break iL If you 
want a Really Good Sharpen Your Pencil for after you've finished this book, come 
back and make tliis server code more robust. 

Another possible Sharpen Your Pencil, diat you could do right now, is to annotate 
this code yourself. You'll understand it much better if you work out what's 
happening than if we explained it to you. Then again, this is Ready-bake code, 
so you really don't have to understand it at all. It's here just to support the two 

versions of the Chat Client. ^ . _. 

I To run thft chat ciJ«iit« you need tmo 
tlnalSi Fir4tp launeh tills Mnmr 
I t»rfnlMlv itmi Iwivt^ tii« 

t 




public class Vary S imp leChatServrer { 
ArrayLlflt clientOutputStreams ; 



public class ClientHandlar iisplements RuimAble ( 
Buf feradReader reader; 
Socket sock; 



public Client:Haxidler (Socket clientSocket) { 
try ( 

sock = clientSocket; 

InputStraainReader isReaddr = new InputStreamReader (aock. gat Inputs treamO ) ; 
reader = now Buf feradRaadar (isRaadar) ; 



} catch (Exception ex) {ax .printStackTraca () ; ) 

} // close constructor 

public void run() { 
String massaga; 
try { 

while {(massage = reader . readLino () ) != null) { 
System. out. printlnC^read + massage) ; 
tellEvaryona (massage) ; 



} // close while 
1 catch (Exception ex) < ex. prints tackTrace () ;) 

) // close run 
} // close inner class 
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public static void main (String {] args) { 
ndw VarySinpleChatSaxver 0 .go() ; 

) 

public void go () ( 

cliantOutputStrQams = new ArrayList(); 
try { 

Servar Socket server SocX = new ServerSocket (5000) ; 

while (true) { 

Socket clientSocket - a erverSock, accept () ; 

PrintWriter writer = new PrintWriter (clientSocket. getOu^utStreamO ) ; 
cliantOut^utStreams . add (writer) ; 

Thread t - new Thread(new ClientHandler (clientSooket) ) ; 
t,fltart 0 ; 

System. out. println (^^got a connection"); 

} 

] catch (Exception ex) { 
ex. prints tackTrace 0 ; 

} 

) I / close go 

public void teXX£veryone (String message) { 

Iterator it ^ cl i en tOu tpu tS treams . iterator () ; 
while ( it . hasNext ( ) ) { 
try { 

PrintWriter writer = (PrintWriter) it.nextO ; 
writer ,println (message) ; 
writer .flush () ; 
} catch (Exception ex) { 

ex .printStackTrace () ; 

} 

) // end while 

) // close tellEveryorie 
V close class 
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DmSinjucstiPtis 

What about protecting static 
variable state? If you have static 
methods that change the static variable 
state, can you still use synchronlxatlon? 

^« YesI Remember that static 
methods run against the class and r\ox 
against an individual instance of the class. 
So you might wonder whose object's lock 
would be used on a static method? After 
all, there might not even beany instances 
of that class. Fortunately, Just as each 
object has its own lock, each loaded class 
has a lock, That means that If you have 
three Dog objects on your heap, you have 
a total of four Dog-related locks.Three 
belonging to the three Dog Instances, 
and one belonging to the Dog class Itself, 
When you synchronize a static method, 
Java uses the lock of the class itself. So if 
you synchronize two static methods In a 
single class,a thread will need the class 
lock to enter either of the methods. 

What are thread priorities? Tve 
heard that's a way you can control 
scheduMng. 

A' 

-'T,- Thread priorities might help 
you Influence the scheduler, but they 
still don't offer any guarantee. Thread 
priorities are numerical values that tell 
the scheduler (If It cares) how important a 
thread Is to you. In general, the scheduler 
will kick a lower priority thread out of the 
running state If a higher priority thread 
suddenly becomes runnable. But... one 
more time, say it with me now, "there 
Is no guarantee." We recommend that 
you use priorities only if you want to 
Influence performance, but never, ever 
rely on them for program correctness. 



Why don't you Just synchronize 
all the getters and setters from the 
class with the data you're trying to 
protect? Like, why couldn't we have 
synchronUed Just the checkBalanceQ 
and whhdrawO methods from class 
BankAccount, instead of synchronising 
the makeWlthdrawalO method from 
the Runnable'fi class? 

^Al* Actually, we should have 
synchronized those methods, to prevent 
other threads from accessing those 
methods in other ways. We didn't bother, 
because our example didn't have any 
other code accessing the account. 

But synchronizing the getters 
and setters (or in this case the 
checkBalanceO and wIthdrawO) Isn't 
enough. Remember, the point of 
synchronization Is to make a specific 
section of code work ATOMICALLY. In 
other words, it's not Just the individual 
methods we care about, it's methods 
that require more than one step to 
comp/etel Think about it.ifwe had not 
synchronized the makeWlthdrawalO 
method, Ryan would have checked the 
balance (by calling the synchronized 
checkBalanceO)/ and ti^^ri immediately 
exited the method and returned the key! 

Of course he would grab the key again, 
after he wakes up, so that he can call 
the synchronized withdrawQ method, 
but this still leaves us with the same 
problem we had before synchronization! 
Ryan can check the balance, go to sleep, 
and Monica can come in and also check 
the balance before Ryan has a chance to 
wakes up and completes his withdrawal. 

So synchronizing all the ^ccesi methods 
is probably a good idea, to prevent 
other threads from getting in, but you 
still need to synchronize the methods 
that have statements that must execute 
as oneatomic unit. 
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Cocte Kitcken 



Closed Ht-Hail 



; Acoustic SnaieQaaDOQaODDOaQODO 

Hrgh Tom 
Hi fiongp^ 
'Caracas 
Whistle 



f Stop i 

{ Tempo Up 3 
{ Tempg Down ) 



QaoDoaocaaoDQQoa 
□ □ d aa □ oaa □ □ □ a a a □ 
sa-Mo«Q a □ «oM □ SOS □ 

□ G G G O OS G G S S G 8 G G G 

aGGOnGGGGGGGGGGG 

CDoaQQDPoa.GwGGoaa 

Low-mJdTom Q Q B B SB B BOOQOQBBB 

Htj,h Agofa ..QasBeeBaBSQBsoBe 



danc6 beat 



Andy: groove #2 
Chris: groove2 revised ^ 
Nigel: dance beat 



Tliis is tke last version of tke BeatBox! 

It connects to a simple MusicServer so tkat you can 
send ami receive keat patterns witk otker clients* 

Tke code is really long, so tke complete listing is 
actually in Appenctix A» 
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Cocte Mag[nets 

A working Java program is scrambled up or^ the fridge. Can 
you add the code snippets on the ne>rt page to the empty 
ciasses below, to rnake a working Java program that pro- 
duces the output listed? Some of the curly braces fell on the 
floor and they were too snnall to pick up, so feel free to add as 
many of those as you need! 




Bonus Question: Why do you think we used the 
modifiers we did in the Accum class? 



J java TestThreads 
one 9S09B 
two 98099 
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Thread one =• new Thread (tl) 
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public class TestThreads { 

public static void main (String [] args) { 
ThreadOne tl = new ThreadOne(); 
ThreadTwo t2 = new ThreadTwo(); 
Thread one = new Thread{tl); 
Thread two = new Thread(t2); 
one-fltart( ) ) 
two-start( ) J 



} 



class Accum { 

private static Accum a = new Accum()? 
private int counter = 0; 




private Accum () { } 



public static Accum getAccumO { 
return a; 

y 

public void updateCounter(iTit add) { 
counter +« add; 

} 

public int getCount() { 
return counter; 

} 

> 

class ThreadOne implements Runnable { 
Accum a = Accum- getAccum( ) ; 
public void run() { 

for (int x=iO; x < 98; x++) { 
a, updateCounter ( 1000 ) ; 
try { 

Thread- sleep (50) ; 
> catch ( interruptedException ex) { } 

} 

System. out. println( "one "+a,getCount( ) ) ; 



Threads from two different ciasses are updating 
the same object in a third class, because both 
threads ore accessing a single instance of ^ccum. 
The line of code: 

private static Accum a = new Accum ( ); creates a 
static \nsiar\ce of Accum (remember static means 
one per class), and the private constructor in 
Accum means that no one else can moke on Accum 
object. These two techniques (private constructor 
and static getter method) used together, create 
what's known os a 'Singleton' - an 00 pattern to 
restrict the number of instances of an object 
that can exist in an application. (Usuolly, there's 
jufff a single \nsiar\ce of a Singleton— hence the 
name), but you can use the pottern to res^ric^ the 
instance creation in whatever way you choose.) 



class ThreadTwo implements Runnable { 
Accmn a = Accum, getAccum( ) ; 
public void run ( ) { 

for(int x=0; x < 99; X++-) { 
a . updateCounter ( 1 ) ; 
try { 

Thread ► sleep ( 50) ; 
} catch (InterruptedException ex) { } 

} 

Syatem^out .println(*two ''+a,getCount ( ) ) ; 



} 



> 



526 chapter 15 



networking and threads 



Near-miss at the Airlock 

As Sarah joined the on-board development team's design review meeting , she gazed out 
the portal at sunrise over the Lidian Ocean, Even though the ship's conference room was 
incredibly claustrophobic, the sight of the growing blue and white crescent overtaking night on 
the planet below filled Sarah with awe and appreciation. 

PlVB-JV^nUf 6 This morning's meeting was focused on the control systems for the orbiter*s airlocks. 

MySfCrY ^ firial construction phases were nearing their end, the number of spacewalks was 
^ scheduled to increase dramatically, and traffic was high both in and out of the ship's 

airlocks. "Good morning Sarah**, said Tom, "Your timing is perfect, we're just starting 
the detailed design review." 




"As you all know*', said Tom, ^'Each airlock is outfitted with space-hardened GUI 
terminals, both inside and out Whenever spacewalkers are entering or exiting the orbiter 
they wiU use these terminals to initiate the airlock sequences." Sarah nodded, 'Tom can 
you teU us what the method sequences are for entry and exit?" Tom rose, and floated to the 
whiteboard, 'Tirst, here's the exit sequence method's pseudocode", Tom quickly wrote on the 
board 

orbiterAirlockExitSequence { ) 
verif yPortalStatus () ; 
pressor izeAir lock 0 ; 
openlnnerHatch () ; 
conflrmAirlockOccupied 0 ; 
closelnner Hatch {) ; 
decompressAirlock () ; 
openOuterHatch () ; 
confirmAirlockVacated { ) ; 



closeOuterHatch () ; 

*To ensure that the sequence is not interrupted, we have synchronized all of the 
methods called by the orbiterAirlockExitSequenceO method", Tom explained ''We'd hate to 
see a returning spacewalker inadvertently catch a buddy with his space pants down!'* 

Everyone chuckled as Tom erased the whiteboard, but something didn't feel right 
to Sarah and it finally clicked as Tom began to write the entry sequence pseudocode on the 
whiteboard ^Wait a minute Tom!", cried Sarah, think we've got a big flaw in the exit 
sequence design, let's go back and revisit it, it could be critical!'* 

Why did Sarah stop the meeting? What did she suspect? 
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What did Sarah know? 

Sarah realized that in order to ensure that the entire exit 
sequence would run without interruption the 

orbiterAirlockExitSeq[uence( ) method needed to 
be synchromzed. As the design stood, it would be possible 
for a returning spacewalker to interrupt the Exit Sequence! 
The Exit Sequence thread couldn't be interrupted in the 
middle of any of the lower level method calls, but it coiddhe 
interrupted in between those calls. Sarah knew that the entire 
sequence should be run as one atomic xmit, and if the orbit 
erAirlockExitSequence ( ) method was synchronized, it 
could not be interrupted at any poinL 
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Sorting is a snap in Java, you have all the toolsfor collecting and manipuiating 
your data without having to write your own sort algorithms (unless youVe reading this right 
now sitting in your Conriputer Scrence 101 classjn which case, trust us— you are SO going to be 
writing sort code while the rest of us Just call a method In the Java API). The Java Collections 
Framework has a data structure that should work for virtually anything you'll ever need to do. 
Want to keep a list that you can easily keep adding to? Want to find something by name? Want 
to create a list that automatically takes out all the duplicates? Sort your co-workers by the 
number of times they've stabbed you in the back? Sort your pets by number of tricks learned? 
It's all here... 
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sorting a list 

tracking song popularity oh your Julcebox 

Congratulations on your new job — managing the automated 
jukebox system at Lou's Diner There's no Java inside the 
jukebox itself, but each time someone plays a song, the 
song data is appended to a simple text file. 

Your job is to manage the data to track song popuJarity, 
generate reports, and manipulate the playlists. You're not 
writing the entire app — some of the other software developer/ 
waiters are involved as well, butyouVe responsible for managing 
and sorting the data inside the Java app. And since Lou has a thing 
against databases, this is strictly an in-memory data collection. All 
you get is the file the jukebox keeps adding to. Your Job is to take it 
from there. 

YouVe already figured out how to read and parse the file, and so fiar 
you've been storing the data in an ArrayList 




SongList.txt 



Pink Moon/Nick Drake 
Somersault/Zaro 7 
Shiva Moon/ Pram Joshua 
Circles/BT 

Deep Channel/A£ro Celts 
Pasaenger/Headmix 
Listen/Tahiti 80 



Challenge #1 

Sort the ftongs in alphabetical order 

You have a list of songs in a file, where each line 
represents one song, and the tide and artist are 
separated with a forward slash. So it should be simple 
to parse the line, and put all the songs in an ArrayList, 

Your boss cares only about the song titles, so for now 
you can simply make a list that just has the song titles. 

But you can see that the list is not in alphabetical 
order., what can you do? 

You know that with an ArrayList, the elements are 
kept in the order in which they were inserted into the 
list, so putting them in an ArrayDst won't take care of 
alphabetizing them, unless... maybe there's a sort() 
method in the ArrayList class? 
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Here's what you have so far: without the sort: 

import java.utii.*; 

public class Jukeboxl ( AtN A^va^i-^^ 

ArrayLiflt<String> songList = new ArrayList<String> ( ) ; 

public static void main (String t 1 args) { 
new Jukeboxl 0 - go () ; 

public void go 0 { *^ ^'^^ ^"'^ , r SITaNUst 

System. out . print in (songList) ; 

.^^ ^^ad tKc ^^^^ 

void gatSongs 0 { aidSor^o^ty 

try { 

File file = new Tile ("'SongList . txfl ; 

Buf feredReader reader = new Buf feredReadar (new FileReader (file) ) ; 
String line = null; 

while ((lin6= reader . readLine () ) J= null) { 
addSong (line) ; 

} 



) catch (Exception ex) { 
ex.prlntStackXrace () ; 

) 

} 



t 

String[] tokens = lineToParse . split ("/") ; ^ ^V'^^^ ^^^^ "^^^ 



void addSong (String lineToParae) ( ^ ^'^^ ^^^) usiLit'^ ^""^ ^"^^^ 



songList. add (tokens [0] ) ; 

) 



you are here ► 531 



%java Jukeboxl 

[Pink Moon, Somersault, 

Shiva Moon, Circles, 

Deep Channel, Passenger, 

Listen] 



ArrayUst API 



Pot the ArrayList class does NOT have a sortO tMethod> 
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collections with generics 



I do see a collection class 
called TreeSet... and the docs 
say that it keeps your data 
sorted. I wonder if I shoufd be 
using a TreeSet instead of an 
/ArrayList... 




ArrayUsf isjiot the owiy collection 

Although ArrayList is the one you'll use most often, 
there are others for special occasions. Some of the key 
collection classes include: 



TreeSet 

Keeps the elements sorted and prevents duplicates. 



> HashMap 

Lefs you store and access elements as name/value pairs. 



UnkedUst 

Designed to give better performance when you insert or delete 
elements from the middle of the collection. (!n practice, an 
ArrayList is still usually what you want.) 



HashSet 

Prevents duplicates in the collection, and given an element, can 
find that element in the collection quickly. 



LInkedHashMap 

Like a regular HashMap, except it can remember the order in 
which elements (name/value pairs) were Inserted, or it can be 
configured to remember the order In which elements were last 
accessed. 
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lava.util.CoHections 



You could use a TreeSet... 

Or you could use the Collections .sortO method 

If you put all the Strings (the song tides) into a TreeSet instead of 
an ArrayList, the Strings would automatically land in the right place, 
alphabetically sorted. Whenever you printed the list, the elements would 
always come out in alphabetical order. 

And that's great when you need a set (we'll 
talk about sets in a few minutes) or when 
you know that the list must ahvays stay 
sorted alphabetically 

On the other hand, if you don*t need the 
list to stay sorted, TreeSet might be more 
expensive than you need^ — euery time you 
insert into a TreeSet^ the TreeSet has to take 
the time to figure out where in the tree the new 
element must go^ With ArrayXist, inserts can 
be blindingly fast because the new element 
just goes in at the end. 



puWicstatlcvoid copy{Ust destination, List source) 
public static List 6mptyList() 
public static void fllKList llstW Oblect ob)ToRlltWrth) 
public staticintfrequency(Colleclionc.Obiedo) 

public static void rever8e{Ust list) 
public static void rotate(Ust list, lot distance) 

public static vni dshuffle^U ^ist)^ 
public static tod soK(Ust list) 



But you CAN add something to an 
ArrayList at a specific index instead of Just at 
the end^there's an overloaded addt) method 
that talces an int along with the element to add. 
So wouidri't ft be siower than Inserting at the end? 



public static boolef 
// many nrvore met 



A: 



Yes, It's slower to insert $orr\ethlrig In an ArrayList 
somewhere of her than at the end. So using the overloaded 
adddndex, element) method doesn't work as quickly as calling 
the add(element)— which puts the added element at the end. 
But most of the time you use Array Lists, you won't need to put 
something at a specific index. 



<l,n ot^j..rfnjdVal. ObiectnewVal) 

» and «iNte i^^ayLisi 
/^•■ayUi^a^eik^deela.^ 



I see there's a Knked List class, so wouldn't that be better for 
doing inserts somewhere in the middle? At least ff I remember my Data 
Structures class from college... 



A: 



Yes, good spot.The LinkedLkt <:fln be quicker when you insert or 
remove something from the middle, but for most applications, the difference 
between middle inserts into a LinkedLlst arid ArrayList Is usually not enough 
to care about unless you're dealing with a huge number of elements. We'll 
look more at LinkedLlst In a few minutes. 



HoU^ ^^^^ . 
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Adding Collections.sortO to the Jukebox code 



import java.utii.*; 
import jciva . io . ; 



potolic class JuJceboxl ( 



ArraYList<String> songLiat = new ArrayList<String> ( ) ; 



The Collection5.sort() 
mediod sopfs a list of 
Strings alpliabetically. 



public void go() f 
getSongs ( ) ; 

Sysi^Gm .out: .prinTiln (^ongLifit) ; 
Colloctiona.sort(songList) ; 
System. out -println (songList) ; 




v/c i d getSongs 0 { 

BMi^m$$^&^M tm^'&f nm^ Buf fex6d?^ader (new Fii^R^ader (file) ) ; 
String line ^ null; 

while ( {lirie= reader . readLine () ) !- nulli ( 
addSong (line) ; 

} 

J cat ch fExcepcion ex) { 
ex . printStaekTiiaGe ( ) ; 



void addSong (String linaToParse) [ 

,S£rin<3[j tokens = lineToParse. spiiL /" ) ; 
SongMst. add (tokens [Q J ) ; 






AJfir- talV^^S 
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l^ut HOW you Heed Song objects, 
HOtJust simple Strings. 

Now your boss wants actuaJ Song class instances in the list, notjust 
Strings, so that each Song can have more data. The newjukebox 
device outputs more information^ so this dme the file will have four 
pieces (tokens) instead of just two. 

The Song class is really simple, with only one interesting feature — 
the overridden toStringO method. Remember, the toStringO 
method is defined in class Object, so every clz^ in Java inherits the 
method. And since the toStringO method is called on an object 
when it*s printed (Systera.ouLprindn(anObject)), you should 
override it to print something more readable than the defiault 
unique identifier code. When you print a list, the toStringO 
method will be called on each object 



class Song ( 

String title; 
String artist; 
String rating; 
String bpm; 



SongUstMorc.txt 



Pink Moon/Nick Drake/S/80 

Somersault/2ero 7/4/84 

Shiva Moon/Prem Joshud/6/120 

Circles/BT/5/110 

Deep Channei/Afro Celts/4/120 

Passenger /Headmix/4/100 

Listen/Tahiti 80/5/90 



TVt sohj s;^^ 
j^rvd wjv>£ All oS^ iK^wv our 

^Idss witl. )r.^t^t watiMts (or all 
\our atlribu^ 



Song(String t, String ay String r. String b) { 



} 



title = t; 
artist - a; 
rating = r; 
bpm = b; 



The vav*^ables art all set i^ 
yve>w Soh^ 15 treated. 



public String getTitleO ( 
return title; 

) 

public String getArtistO { 
return artist; 

} 

public String getRatingO { 
return rating; 

) 

public String getBpmO ( 
return bpm; 

) 

public String toStringO 
return title; 

) 
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Changing the Jukebox code to use Songs 
instead of Strings 

Your code changes only a little — the file I/O code is the same, 
and the parsing is the same (String.splitO), except this time 
there will be /owr tokens for each song/line, and all four v^nill be 
used to create a new Song object. And of course the ArrayList 
will be of type <Song> instead of <String>. 



import j ava . util . * ; ArravUi't <^ 

import java.io.S- ^^^t^^^^^^ ^ 

public class Jukebox^^i^^^ 

ArrayList<Song> songList = new ArrayList<Song>{) ; 

public static void main {String [ j args) { 
new O'ukebox3 0 .go () ; 

} 

public void go() { 
getSongs (} ; 

System, out .println (songList) ; 
Collections . sort (songList) ; 
System. out sprint In (songList) ; 

1 

void gatSongsO { 
try { 

File file ^ new File ('\SongList, txt") ; 

Buf f eredReader reader ^- new But feredReader (new FileReader (file) ) ; 
String line ^ null; 

while ( (line== reader . readLine () ) null) { 
addSong (line) ; 

} 

} catch (Exception ex) ( 
ex.printStackTrace () ; 

} 

} 

void addSong (String lineToFarse) { 

String [ ] tokens lineToParse . split C\/'') ; 

Song nextSong = new Song (tokens [0] , tokens [1], tokens [2], tokens[3]); 
songList. add (nextSong) ; 

} 
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It woH't compile! 

Something's wrong... ihe Collections class clearly shows there's a 
sort() mediod, that takes a List. 

ArrayList is-a List, because ArrayList implements the List interface, 
so... it should vfork^ 

But it doesn't! 

The compiler says it can't find a son method that takes an 
AxrayList<Song>, so maybe it doesn*t like an ArrayList of Song 
objects? It didn't mind an AjrrayList<String>, so what*s the 
important difference between Song and String? What s the 
difference that's making the compiler fail? 



File Bdll Window Heifk BymflMf 



%javac Jukebox3oava 

JukeboxS. java: 15 : cannot find symbol 

symbol ; method sort(java.util.ArrayList<Song>) 

location : class java , util . Collections 

Collections . sort (songList) ; 

A 

1 error 



And of course you probably already asked yourself, ''What would it 
be sorting ^m?'* How would the sort method even Anmi; what made 
one Song greater or less than another Song? Obviously if you want 
the song*s title to be the value that determines how the songs are 
sorted, you'll need some way to tell the sort method that it needs 
to use the tide and not, say, the beats per minute. 

WeMl get into all that a few pages from now, but first, let's find out 
why the compiler won't even let us pass a Song ArrayList to the 
sort() method. 
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[ WTF? I have no idea how to 
read the method declaration 
on this. It says that sortQ 
takes a L(St^T>, but what is 
T? And what is that big thing 
before the return type? , 



o 




Sorts the specified list into ascending order, according to the nniural ordering of its elements. All 
elements in the list must implement the comparable interface. Purthcrmorc, all dements in the Ust 
must bt muiuaUy comparable (that is, el.compareTo[e2) must not throw a ciaaaCaatEicception 
for any elements ai and a^ in the list). \ 



From the API docs (looking up the java.util. Collections class, and scrolling to the sort{) 
method), it looks like the son() method is declared... strangely. Or at least different from 
anything we've seen so far. 

That's because the son() method (along ^vitl"* other things in the whole collection framework in 
Java) makes heavy use of genres. Anytime you see something with angle brackets in Java source 
code or documentation, it means generics — a feature added to Java 5.0. So it looks like we'll 
have to leam how to interpret the documentation before we can figure out why we were able to 
sort String objects in an ArrayList, but not an ArrayList of Song objects. 
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Generics mam more type-safety 

We'll just say it right here — virtually all of the code you write that deals 
rvith generics will be collection-related code^ Although generics can be used 
in other ways, the main point of generics is to let you write type-safe 
collections. In other words, code that makes the compiler stop you 
from putting a Dog into a list of Ducks. 

Before generics (which means before Java 5.0), the compiler could 
not care less what you put into a collection, because all collection 
implementations were declared to hold type Object. You could put 
anything in any ArrayList; it was like all ArrayLists were declared as 
ArrayList<Obiect>. 



WITHOUT generics 

Objects go IN as a reference to 
SoccerBall, Fish, Guitar, and 
Car objects 



4Kh 



ArrayList 



i i i i 



And come OUT as a reference of type Object 



W&i generics, you can 
create type-safe collecfions 
^ere inore problems are 
caught at comi^le-time 
instead of runtime. 

Widiotttgene]^cs,flie 
coupler would Kappily let 
you put a Piin^lin into an 
ArrayList to was si$posed 
to hold only Cat objects. 



WITH generics 

Objects go IN as a reference to 



only Fish objects 



I I I I 



ArrayList<Fish> 



I I I i 



And come out as a reference of type Fish 
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Learning generics 

Of the dozens of things you could learn about generics, there are 
really only three that matter to most programmers: 



Creating instances of generified classes (like ArrayLlst) 

When you make an ArrayList, you have to tell it the type 
of objects you'll allow in the list, just as you do with plain 
old arrays. 



new ArrayList<Song>() 



Declaring and assigning variables of generic types 

How does polymorphism really work with generic 
types? If you have an ArrayList<Animal> reference 
variable, can you assign an ArrayList<Dog> to it? What 
about a List<Animal> reference? Can you assign an 
ArrayList<Animal> to it? You'll see... 



List<Song> songList = 

new ArrayList<Song>() 



^ Declaring (and invoking) methods that take generic types 

If you have a method that takes as a parameter, say, an void f oo (List<Song> list) 

ArrayList of Animal objects, what does that really mean? 

Can you also pass it an ArrayList of Dog objects? We'll _ f oo (songList} 

look at some subde and tricky polymorphism issues that 
are very different from the way you write methods that 
take plain old arrays. 

(This is actually the same point as #2, but that shows you 
how important we think it is.) 



But don't I also need to learn how to create my OWN generic 
dasses? What if I want to make a class type that lets people 
instantiating the class decide the type of things that class will use? 

A- 

You probably won't do much of that. Think about it — the API 
designers made an entire library of collections classes covering most of 
the data structures you'd need, and virtually the only type of classes that 
really need to be generic are collection classes. In other words, classes 
designed to hold other elements, and you want programmers using it to 
specify what type those elements are when they declare and instantiate 
the collection class. 

Yes, it is possible that you might want to create generic classes, but that's 
the exception, so we won't cover it here. (But you'll figure it out from the 
things we do cover, anyway.) 
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Using generic CUSSES 



Since ArrayList is our most-used generified type, we'll 
start by looking at its documentation. They two key areas 
to look at in a generified class are: 

1) The 6:Za55 declaration 

3) The method declarations that let you add elements 



Understanding ArrayList documentation 
(O5 what's the true meaning of ^E"?) 



TIi5i4 of as a stand-in for 
*flie fj/pe of element yon want 

collection to KoH and 
retupn." (E is for Element.) 



public class ArrayLlst<E> extends AbstractList<E> in^lements List<E> ... { 

J 

public boolean add(E o) r c ^ 

\_ TK« hf(t. (iKe valw: of <t>) 

deWmes k»v^ <^ youVe allowed mter+adc as well, 

to add to the Av^ayUsi 

// more code 



The "E" represents the type used to create an instance 
of ArrayList. When you see an "E" in the ArrayList 
documentation, you can do a mental find/ replace to 
exchange it for whatever <type> you use to instantiate 
ArrayList. 

So, new ArrayList<Song> means that "E" becomes "Song", 
in any method or variable declaration that uses "E". 
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Usihg type parameters with Arraylist 



THIS code: 

ArrayList<String> thisList = new ArrayList<String> 




7 



Means ArrayList: 

public class ArrayL±st<B> m/tEitiiis AbstractList<E> ... { 

public boolean add(E o) 
// more code 

} 

Is treated by the compiler as: 

public class AxrayLi3t<String> extends Ab3tractList<String>. . . { 

public boolean add (String o) 
// more code 

} 

In other words, the ''E*' is replaced by the real type (also called the type parameter) 
that you use when you create the ArrayList And that's why the addQ method 
for ArrayList won't let you add anything except objects of a reference type that's 
compatible with the type of "E". So if you make an ArTayList<Strmg>, the add() 
method suddenly becomes add(String o) . If you make the ArrayList of type Dog, 
suddenly the add{) method becomes add(Dog o). 



Is "'G" the oniy thing you can put there? Because the docs for sort usedH'T.,. 

A- 

You can use anything that's a legal Java Identifier. That means anything that you 
could use for a method or variable name will work as a type parameter. But the conven- 
tion is to use a single letter (so that's what you should use), and a further convention fs to 
use^'T^'uniess you're speclflcaiiy writing a collection class, where you'd use^E^to repre- 
sent the^type of the Eiement the coilectlon wiii hoid'^ 
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Usihg generic METHODS 



A generic class means that the ci4iss declaration includes a type 
parameter. A generic method means that the method declaration 
uses a type parameter in its signature. 

You can use type parameters in a method in several different ways: 
^ Using a type parameter defined In the class declaration 

public class ArrayList<E> extends AbstxactList<E> , . . { 
public boolean add(E o) Vou 



When you declare a type parameter for the clasSj you 
can simply use that type any place that you*d use a 
realclzss or interface type. The type declared in the 
method argument is essentially replaced with the type 
you use when you instantiate the d^ss. 



^ Using a type parameter that was NOT defined In the class declaration 



public <T extends Animal> void take Thing (Array Li st<T> list) 





If the class itself doe^n^t use a type parameter, you can still 
specify one for a method, by declaring it in a really unusual 
(but available) space — before the return type. This method says 
that T can be ''any type of Animal'*. 
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Wait... that can't be right. If you can 
takeo liJt of Animal, why don't you 
just SAY that? What's wrong with just 
fokeThing(ArrcyUsf^ Animal > Hsf)7 



O 

o 



Here's where it gets weird... 



This: 



pybli^ <T extond^ ASiijaal> void t3JceThing(ArrayLi3t<T> list) 



Is NOT the same as this: 

public void takeThing ( ArrayLiat<Animal> list) 

Both are legal, but theyVe differentl 

The first one, where <T eictends Aiiimal> is part of the method 
declaration^ means that any ArrayList declared of a type that is 
Animal, or one of Animal's subtypes (like Dog or Cat), is legal. 
So you could invoke the top method using an ArrayLisL<Dog>. 
ArrayList<Cat>, or Array Lis t<Animal>. 

But... the one on the bottom, where the method argument is 
(ArrayList<Animal> hst) means that only an ArrayList<Animal> 
is legal. In other words, while the first version takes an ArrayList 
of any type that is a type of Animal (Animal, Dog, Cat, etc.)i 
the second version takes cw/jy an ArrayList of type Animal. Not 
ArrayList<Dog>, or ArrayList<Cac> but only ArrayList<Animal>. 

And yes, it does appear to violate the point of polymorphism, 
but it will become clear when we revisit this in detail at the end 
of the chapter. For now> remember that we're only looking at 
this because we're still trying to figure out how to sort() that 
SongList^ and that led us into looking at the API for the sort() 
method, which had this strange generic type declaration. 

For myw, all you need to know is that the syntax of the top version 
is ^egaJ, and that it means you am pass in a ArrayList object 
insiantiated as Animal or any Animal subtype^ 



And now back to our sort() method... 
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sorting a Song 




Remember where we were... 



I "Fil* EdU Window Help Bjjrrvtwr 



% j avac Jukebox3 . j ava 
Jukebox3 . java; 15 ; cannot find symbol 



symbol : method sort (java.util.ArrayList<Song>) 
location: class java, util -Collections 

Collections. sort (songList) ; 



import java . util , 
import java.io.*; 

public class Jukebox3 ( 

ArrayList<Song> songList = new ArrayLiat<Song>() ; 

public scatic void main (String [ ] args) ( 
new JukeboxB () .go 0 ; 



I 

public void go() { 
getSongs () ; 

System. out . println (songList) ; 



L V^y^Aki' It worked 



System. out. println (songList); ^i^J t<> ^ 
} 

void g«tSongs() ( 

try f 

File file = new File ("SongList . txt") ; 

Buf feredReader reader = new Buff eredReader (new FileReader (file) ) ; 
String line = null; 

while ( (line= reader . readLine () ) != null) { 
addSong (line) ; 

} 

1 catch (Exception ex) { 
ex .printStacJcTrace 0 / 

1 

) 

void addSong (String lineToParse) ( 

StringO tokens = lineToParse , split ("/") ; 

Song nextSong = now Song (tokens [0] , tokens [1], tokens [2] ^ tokens[3]); 
songList. add (naxtSong) ; 

) 
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Revisiting the sortO method 

So here we are, trying to read the sort{) method docs to find 
out why it wa5 OK to sort a list of Strings, but not a 
list of Song objects. And it looks like the answer is.. 



The sortO method can take only lists 
of Comparable objects. 

Song is NOT a subtype of 
Comparable, so you cannot sortQ 
the list of Songs. 

At least not yet... 



public static <T extends Coii^arabld<? super T» void sort(Liat<T> list) 





^jjhore (o^ ^ov,. But 



-ttia-t tKtf type pa>-af^^ter -fo^ 
Compdvjblc >«uit b« ^ -type r 



^ou CJtk paw only d Lut (<a^ 
subtype l-.kc A^rvayL-.st) 

tKat us^ a pairdr».ct^viz^d -type 
tKat V-lwis Comparable . 



Urn.., I jurt checked the docs for 
String, and String doesn't EXTEND 
Comporobie-Ht IMPieMENiTS ft. 
^^parable 15 on interface. So if s nonsense 
to soy <T extends 0?mporabIe>. 



public final class String extends Object implementa Sdrializahle , 

Coinpax«l>le<String> , CharSequ^nce 
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In generics^ ''extends'' means 
"extends or implements" 

The Java engineers had to give you a way to put a constraint 

on a parameterized type, so that you can restrict it to, say, only j p # % h 

subclasses of Animal. But you also need to constrain a type to ^ genellCSj thC KGyWOPCl 

allow only classes that implement a particular interface. So ^^GXtGUcfe^ rBftllV DIGSBS ^iS'"^^^ 

here's a situation where we need one kind of syntax to work J ' 

for both situations — inheritance and implementation. In other Slid WOFm foP BO 1 IJ clsSS^S 
words, that works for both extends and implements. 



And the winning word was... extends. But it really means "is-a**, 
and works regardless of whether the type on the right is an 
interface or a class. 



and interfaces. 



REALLY vcads, ^ust be a ivf e tKat 

public static <T extends Coitiparable<? super T» void sort(List<T> list) 

li <io€&v\i watier wKeiKev" iHc iKmj oy\ i\\t irigh-t is 
a dtass or mtcv^aite... you sfcll say \%ic^ds\ 



Why didn't they just make a new keyword^^is''? 



A- 

Adding a new keyword to the language is a REALLY big deal because 
it risks breaking Java code you wrote in an earlier version. Think about 
it — you might be using a variable "is" (which we do use in this book to repre- 
sent input streams). And since you're not allowed to use keywords as identi- 
fiers in your code, that means any earlier code that used the keyword before 
it was a reserved word, would break. So whenever there's a chance for the 
Sun engineers to reuse an existing keyword, as they did here with "extends" 
they'll usually choose that. But sometimes they don't have a choice.,. 

A few (very few) new keywords have been added to the language, such 
as assert in Java 1 .4 and enum in Java 5.0 (we look at enum in the appen- 
dix). And this does break people's code, however you sometimes have the 
option of compiling and running a newerversion of Java so that it behaves 
as though it were an older one. You do this by passing a special flag to the 
compiler or JVM at the command-line, that says, "Yeah, yeah, I KNOW this is 
Java 1 .4, but please pretend it's really 1 .3, because I'm using a variable in my 
code named assert that I wrote back when you guys said it would OK!#$%'I 

(To see if you have a flag available, type javac (for the compiler) or Java (for 
the JVM) at the command-line, without anything else after It, and you should 
see a list of available options. You'll learn more about these flags in the chap- 
ter on deployment.) 



548 ch^ter 18 



collections with generics 



Fihally we know what's wrong... 

The Song class needs to impleitient Comparable 

We can pass the ArrayLLst<Soog> to the soa() method onJy if the 
Song class implemenis Comparable, since that's the way the sort() 
method was declared. A quick check of the API docs shows the 
Comparable interface is really simple, with only one method to 
implement 

java.lang.Comparable 



public interface Coiiq>arable<T> ( 
> 



And the method documentation for compareTo() says 



a negative integer, zero, or a 
positive integer as this object 
is less than, ecjual to, or greater 
than the specified object. 



It looks like the compareTo() method wij] be called on one 
Song object, passing that Song a reference to a different 
Song. The Song nmning the compareTo() method has to 
figure out if the Song ii \vas passed should be sorted higher, 
lower, or the same in the list 

Your big job now is to decide what makes one song greater 
than another, and then implement the compareToO method 
to reflect that. A negative number (any negative number) 
means the Song you were passed is greater than the Song 
nmning the method. Returning a positive number says 
that the Song running the method is greater than the Song 
passed to the compareTo() method. Returning zero means 
the Songs are equal (at least for the purpose of sorting... it 
doesn't necessarily mean theyVe the same object). You might, 
for example, have two Songs with the same title, 

(Which brings up a whole different can of worms we'll look 
at later..) 



The big question is: what 
makes one song less than, 
equal tOp or greater than 
anoihBr song? 

You can't implement the 
Comparable Interface until you 
make that decision. 



-<^^en your pencil 



W/rite in your idea and pseudo code (or 
better, REAL code) for Implementing the 
compareToO metl^od in a way that will 
sortO the Song objects by t\t^e. 

Hint; If you're on the right tract (t should 
take less than 3 lines of code! 
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the Comparable interface 



The hew, improved, comparable Song class 

We decided we want to sort by tide, so we implement the compareToO 
method to compare the tide of the Song passed to the method against 
the tide of the song on which the compareToO method was invoked. 
In other words, the song running the method has to decide how its 
diJe compares to the dde of the method parameter 

Hmmjn... we know that the String class mtist know about alphabeucal 
order, because the sort() method worked on a list of Strings. We know 
String has a compareToO method^ so why not just cali i\? That way we 
can simply let one tide String compare itself to another, and we don't 
have to vmte the comparing/alphabetizing algorithm! 



class Song i mplftmenta Coinparable<Song> { 

String title; 
String artist; 
String rating; 
String bpm; 



Usually i^cu maUK...wcV« s^et^%.^ t^c iyft 



public int con^areTo (Song a) { 

return title , compareTo (s . getTi tie () ) ; 

} 



U i« ^ov; that to^Y^ra. io £0^5 of^ 



Song (String t/ 
title = t; 
artist ^ a; 
rating = r; 
bpin = !b ; 

} 



public String getTitleO { 
return title; 



public String getArtist() { 
return artist; 

1 

public String getRatingO ( 
return rating; 

) 

public Stiring getBpm() ( 
return bpm; 

} 

public String toStiringO { 
return title; 



String a, String r, String b) { 



Of^ io tile Stv-in^ objCdU 



TKis -twe it ^<^Vti. \i liit, th^n .0^ 

I £(f<l Window H&lp Amaiopr^^^^ 



} 
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%java Jukebox3 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep 
Channel , Passenger , Listen] 

[Circles, Deep Channel, Listen, Passenger, Pink 
Moon, Shiva Moon, Somersault] 



collections with generics 



We caw sortfbe list bat... 

There *s a new problem — Lou wants nvo different views of the song list, 
one by song title and one by arristi 

But when you make a collection element comparable (by having it 
implement Comparable) , you get only one chance to implement the 
compareToO method. So what can you do? 

The horrible way would be to use a flag variable in the Song class, 
and then do an i/test in compareTo() and give a different result 
depending on whether the flag is set to use tide or ardst for the 
comparison. 

But that s an awful and brittle solution, and there's something much 
better. Something built into the API forjust this purpose — ^when you 
want to sort the same thing in more than one \\'ay 

Look at the Collections class API again. There^s a 
second sort() method — and It takes a Comparator. 



That's not good enough. 
Sometimes I wont it to sort 
by artist ir^tead of title. 



o 




Colltitiioris (Java 2 Platform SE S.O] 



5 file:///Users/kathy/Public/docs/apl/index.html 



;^iOc' Google 



<K,V> Kap<K>V> 



We out 



static 
5r T» 
void 



Returns an immutable map, mapping only the 
specified key to tbc specified vabc. 



aort ( Li3t <T> list) 

Sorts tbe specified list into ascending order, 



according to the ncntral ordering of its elements. 
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the Comparator interface 



Using a miom Comparator 

An element in a list can compare itself to another of 
its own type in only one way, using its compareToO 
method. But a Comparator is external to the element 
type you're comparing — it's a separate cla^. So you can 
make as many of these as you like! Want to compare 
songs by artist? Make an ArtistComparator. Sort by beats 
per minute? Make a BPMCompriraton 

Then all you need to do is call the overloaded sort() 
method that takes the List and the Comparator that will 
help the sort() method put things in order 

The sortO method that takes a Comparator wiU use the 
Comparator instead of the element's own compareTo() 
method, when it puts the elements in order In other 
words, if your sort() method gets a Comparator, it won't 
even ^:a/Zthe compareTo() method of the elements 
in the list The 5ort() method will instead invoke the 
compareQ method on the Comparator 

So, the rules are: 



java.utiLCoinparator 



public intarfaca Con?>arator<T> { 
} 



If you pass a Can^arator to flie 
sortO mefliod, -die sort order is 
deternfijtied by ^ Comparator 
rafiier ^an ^ element's own 
coirf areTo() mediod. 



> Invoking the one-argument sort(List o) method 
means the list element's compareToO method 
determines the order. So the elements In the list 
MUST Implement the Comparable Interface. 



> Invoking sort(Ust o, Comparator c) means the 
list element's compareToQ method will NOT be 
called, and the Comparator's compareQ method 
will be used Instead. That means the elements 
In the list do NOT need to Implement the 
Comparable Interface. 



So does this mean that if you have a class that 
doesn't Implement Comparable, and you don't have the 
source code, you could still put the things in order by 
creating a Comparator? 

A- 

That's righi.The other optfon (if it's possible) would be 
to subclass the element and make the subclass implement 
Comparable. 



But why doesn't every class Implement Comparable? 

A- 

Do you really believe that everything can be ordered? 
If you have element types that Just don't lend themselves to 
any kind of natural ordering, then you'd be misleading other 
programmers if you Implement Comparable. And you aren't 
taking a huge risk by not Implementing Comparable, since 
a programmer can compare anything In any way that he 
chooses using his own custom Comparator. 
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collections with generics 

UpdatiHQ the Jukebox to use a Comparator 

We did three new things in this code: 

1) Created an inner class that implements Comparator (and thus the compare() 
method that does the work previously done by compareTb()). 

2) Made an instance of the Comparator inner class. 

S) Called the overloaded sort() method, giving it both the song list and the 
instance of the Comparator inner class. 

Note: we also updated the Song class toStringO method to print both the song 
tide and the artist (It prints tiife; oiti^ regardless of how the list is sorted.) 



import java . util . 
import java.io,*; 



public class JoXeboxS { 

AxrayList<Song> songLaist = new ArrayList<Song> 0 ; 
public static void main (String [ ] args) { 
new JukeboxS () . go { ) ; 

} 



Cr^Aii a t<w t\ass tKat implements 

Comparator Uoht b^di typt 
^ wrdmet£r mat^Kci tKe bfft ^Jt Aoinj 
to 6o«>parc-vn tiiis Sm^9 obje^ts-^ 



claafl ArtistiComparo inylementfl Comparator<Song> { 
public int conq&are (Song one, Song two) { 

return one.getArtist () .con^iareTo (two.getArtist () ) ; 



public void go ( ) ( 
getSongs ( ) 

System. ou t -println (songList) ; 
Collections , sort (songList) ; 
System- out.printin (songList) ; 



Make an instati/i€ of tK« 

Comparator inner tlaw. 



ArtiatCotnpare artistCozcpare = new ArtistCompare () ; 
Collections, aort (aongliist, artiatCompare) ; 

P^«in9 ii iMc IH 

System. out.printin (songList) ; a >rt^crtnu tolK^ 

void getSongs 0 { 

// I/O code here 

1 

void addSong (String lineToParse) { 

// parse line and add co song list 

} 



Note: weVe made sort-by-title the default sort, by 
keeping theconnpareToO method In Song use the 
titles. But another way to design this would be to 
Implement both the title sorting and artist sorting as 
Inner Comparator classes, and not have Song implement 
Comparable at alLThat means we'd always use the two- 
arg version of Collections.sortO- 
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collections exercise 

import ; 

public class SortMountains { 

LinkedList mtn = new LinkedLiat 

class NameCompare { 

public int compare (Mountain one, Mountain two) { 

return ; 

> 

} 

class HeightCompaxe { 

public int compare (Mountain one, Mountain two) { 

return ( ) ; 

} 

} 

public static void main (String [] args) { 
new SortMountain ( ) - go ( ) ; 

> 

public void go( ) { 

mtn. add (new Mountain ( "Longs" , 14255)); 
mtn.add(new Mountain ( "Elbert" , 14433)); 
mtn,ddd(new Mountain ( "'Maroon" , 14156)); 
mtn.add(new Mountain ( "Castle" , 14265)); 

System, out. println( "'as entered An" + mtn); 
NameCompare no = new NameCompare( ) ; 



System.out .println{ ''by nameiXn" + mtn); 
HeightCompare he = new HeightCompare ( ) ; 



System- out, println( "by height :\n" + mtn); 

} 

} 

class Mountain { 

' Output: 

I Rl6 Edh Window Help ThIsOne'aFofeob I 

{ 



} 

{ 



> 

> 
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4^^pen your pencil 



_(); 



Re^verse EngftieeF 

Assime llus code exists in 
a sin^e file. Your joB is 
to fill in blaiiks So 
tie pTograni will create ^ 
ovd^ shown. 

Note: answers are at the end of 
the chapter. 



%java SortMountains 
as entered: 

[longs 14255, Elbert 14433, Maroon 14156, Castle 14265] 
by name: 

rcastle 14265, Elbert 14433, Longs 14255, Maroon 14156) 
by height: 

(Elbert 14433, Castle 14265, Longs 14255, Maroon 14156] 



collections wtth generics 

For each of the questions below, fill in the blank 
with one of the words from the "possible answers" 
list, to correctly answer the question. Answers are 
at the end of the chapter. 

Possible Answers: 

Comparator, 
Comparable, 
compareTo( ), 
compare( ), 
yes, 
no 

Given the following compilable statement- 
Collections, sort (myArrayList) ; 

1. What must the class of the objects stored in myArrayList implement? 

2. What method must the class of the objects stored in myArrayList implement? 

3. Can the class of the objects stored in myArrayList implement both 

Comparator AND Comparable? 



Crfven the following compilable statement: 

Collections . sort (myArrayList, myCompare) ; 

4. Can the class of the objects stored in myArrayList implement Comparable? 

5. Can the class of the objects stored in myArrayList implement Comparator? 

6. Must the class of the objects stored in myArrayList implement Comparable? 

7. Must the class of the objects stored in myArrayList implement Comparator? 

8. What must the class of the myCompare object implement? 

9. What method must the class of the myCompare object implement? 
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dealing with duplicates 

Uh-oh. The sorting all works, bat now we have duplicates... 

The sorting works great, now we know how to son on both title (using the Song object's 
compareToO method) and artist (using the Comparator's compare() method). But there's 
a new problem we didn't notice ^vith a test sample of the jukebox text file — the sorted list 
contains duplicates. 

It appears that the diner jukeboxjust keeps writing to the file regardless of whether the 
same song has already been played (and thus wrinen) to the text file. The SongListMore.txt 
jukebox text file is a complete record of every song that was played, and might contain the 
same song multiple times. 



ijava JuIcebox4 



1 



tPink Moon: Nick Drake, Somersault: Zero 1, Shiva Moon: Prem 
Joshua, Circles: BT, Deep Channel: Afro Celts, Passenger: 
Headmix, Listen: Tahiti 80, Listen; Tahiti 80, Listen: Tahiti 
80, Circles: BT] 

[Circles: BT, Circles: BT, Deep Channel: Afro Celts, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Passenger: 
Headmix, Pink Moon: Nick Drake, Shiva Moon: Prem Joshua, 
Somersault: Zero 7] 

[Deep Channel: Afro Celts, Circles: BT, Circles: BT, Passenger: 
Headmix, Pink Moon: Nick Drake, Shiva Moon: Prem Joshua, Listen: 
Tahiti 80, Listen: Tahiti 80, Listen: Tahiti 80, Somersault: 
Zero 7] 



(iM. fev title)- 

K 

artist tia»<)- 



SongLJst AAore.txt 



Pink Moon/Nick Drake/5/80 

Somersault/2ero 7/4/84 

Shiva Moon/Prem Joshua/6/120 

CiEcles/BT/5/nO 

Deep Channel/Afro Celts/4/120 

Passenger/Headmix/4/100 

Listen/Tahiti 80/5/90 

Listen/Tahiti 80/5/90 

Listen/Tahiti 80/5/90 

Circles/BT/5/nO 



K« ti-.*s r '^''"i'd Jp?,y -sr^ 

9^ th« j^^a 
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collections with generics 



'We heed a Set instead of a List 



'From the Collection API, we find three main interlaces^ List, Set, and 
Map. ArrayList is a list, but it looks liJke Set is exacdy what we need. 



LIST - when sequence matters 

Collections that know about Index position. 

Lists know wfiere something is In the list You 
can have more than one element referencing 
the same object 




List 



V SET - when uniqueness matters 

Collections ^at do noi allow duplicates. 

Sets know whether something is already in the collection. 
You can never have more than one element referencing 
the same object (or more than one element referencing 
two objects that are considered equal— we'll look at what 
object equality means in a moment). 





Set 



MAP - when finding son^ethlng by key matters 

Collections that use key-value pairs. 
Maps know the value associated with a given key You 
can have two keys that reference the same value, but you 
cannot have duplicate keys. Although keys are typically 
Stn'ng names (so that you can make name/value property 
lists, for example), a key can be any object. 



"Balll" 


'<Ball2» 


"Fish" 


"Car" 



Map 
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the collections API 



The Collection API (part of it) 



Notice that the Map interface doesn't 
acnialiy extend the Collection interface, 
but Map is still considered pan of the 
"Collection Framework" (also known 
as the "Collection AFF). So Maps are 
sdll collections^ even though they don't 
inciudejava.util, Collection in their 
inheritance tree. 



Collection 
(interface) 



(Note: this is not the complete 
collection API; there are other 
classes and interfaces, but 
these are the ones we care 
most about) 



Set 
(interface) 



List 
(interface) 




T 



KEY 




extends 
implements 
implementation class 
Interface 



TreeMap 



Map 
(Interface) 



SoiiteM^p 
(interface) 



-51 




HashMap 



Alaps don't t^icYid ^roT« 

lava ut;I.Ci>!lci'tjcm, but 
t,\\c^Vc still CcY^idcxtA 
to be pa^ o( b\t 

stil Yt^cryrtd to ai a 

d oiled tion- 



LinkedHashMap 



1 ^MM^^ 
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collections with generics 



Using a HashSet instead of ArrayList 

We added on to the Jukebox to put the songs in a HashSet. (Note: we left out some 
of the Jukebox code, but you can copy it from earlier versions. And to make it easier 
to read the output, we went back to the earlier version of the Song's toStringO 
method, so that it prints only the tide instead of tide an^/ artist.) 

import java-util.^; 
import java . io . 

public class JukeboxS ( 

ArrayList<3ong> songList = new ArrayList<Soag> ( ) ; <f 



// main method ^tb. 
public void gof) f 



getSongs ( ) 

System. CHit .jprincin (^onftisc) ; 
Collacti;qfS$.*Sor t r:ug:.i-^z) ; 
System, out , pr; n:.! ri ( r*:! jLi^t ) ; 



HaahSet<Song> songSet = new HashSet<Song>() ; 
a ongSe t. addAll (songList) ; m — u^.rti 
System. out. println(songSet) ; take ahotW iol/i-^+i^. 



S.^J^i^' V'rt 



getStongs O ^nd addSmg(^ methods ^ ^^^f^ '^wih li^p(^). 



Fa» Edii Window/ Herp Q$ifi$^rML«ic 



%java Jukebox€ 

[Pink Moon, Somersault, Shiva Moon, Circles, Deep Channel, 
Passenger, Listen, Listen y Listen, Circles] 

[Circles, Circles, Deep Channel, Listen, Listen, Listen, 
Passenger, Pink Moon, Shiva Moon, Somersault] 

[Pink Moon, Listen, Shiva Moon, Circles, Listen, Deep Channel, 
Passenger, Circles, Listen, Somersault] 



(by title)- 



TKff S^t did>^'-t hdp// (And it lost its so^ ordor 

' the dupk^ates / ^^^^^^ tut well wo^7 ^^^^ 

tKat ^r^t latc^- ■) 



A^tcv putt''i^5 it 

mto a HasKS^i 
N HaiKSet (wc didr^'t 
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If two objects foo and bar are 
equal, foo,Gquals(b0f) must be 
true, and both foo and bar must 
return the same value from 
hashCodG()s For a Set to treat 
two objects as duplicates, you 
must override the hashCode() 
and equatsO methods inherited 
from class Object, so that you 
can make two different objects 
be viewed as equal. 



Object equality 

What makes two objects equal? 

Firsts we have to ask — what makes two Song references 
duplicates? They must be considered eqiiai. Is it simply two 
references to the very same object, or is it two separate objects 
that both have the same liil^ 

This brings up a key issue: refemice equ^dity vs. o^'^ri equality. 



> Reference equality 

Two references, one object on the heap, 

Two references that refer to the same object on 
tlie heap are equal. Period. If you call the hashCodeQ method on 
both references, you'll get the same result If you don't override the 
hashCodeO method, the default behavior (remember, yoti inherited 
this from class Object) is thai each object will get a unique number 
(most versions of Java assign a hashcode based on the object's 
memory address on the heap, so no two objects Mil have the same 
hashcode). 

If you want to Iciow if two rBfer$nce$ are realty referring to the same 
object, use the == operator, which (remember) compares the bits in 
the variables. If both references point to the same object, the bits will 
be [denticaL 




Song 

if {foo " bar) { 

// both references are referring 
// to the same object on the heap 



Object equality 

Two references, two objects on the heap, but 

the objects are considered mBanlngfully equivalent 

If you want to treat two different Song objects as equal (for 
example if you decided that two Songs are the same if they have 
matching title variables), you must ovenide both the hashCodeQ 
and equalsQ methods inherited from class Object 

As we said above, if you don? ovenide hashCode(), the default 
behavior (from Object) is to give each object a unique hashcode 
value. So you must override hashCodeO to be sijre that two 
equivalent objects retum the same hashcode. But you must also 
override equalsQ so that if you call it on e/t/rer object, passing in 
the other object, always returns trm, 

if ( foe. equals (bar) 




foo.haehCodeO 



Song 



bar. hashCodeO ) { 



// both references are referring to either a 

// a single object, or to two objects that are egual 
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collections with generics 



How a HashSet checks for duplicates: hasbCodeO and equalsO 



When you put an object mto a Hashset, it uses the 
object's hashcode value to determine where to put 
the object in the Set. But it also compares the object's 
hashcode to the hashcode of all the other objects in 
the HashSet, and if there^s no matching hashcode, 
the HashSet assumes that this new object is not a 
duplicate. 

In other words, if the hashcodes are diflFerent, the 
HashSet assumes there *s no way the objects can be 
equall 

So you must override hashCode() to make sure the 
objects have the same value. 

But two objects with the same hashCode() might not 
be equal (more onjhis on the next page), so if the 



HashSet finds a matching hashcode for two objects — 
one youVe inserting and one already in the set — the 
HashSet will then call one of the object's equals() 
methods to see if these hashcode-matched objects 
really ^ equal. 

And if they're equal, the HashSet knows that the 
object you're attempting to add is a duplicate of 
something in the Set, so the add doesn't happen. 

You don*t get an exception, but the HashSet's add() 
method returns a boolean to tell you {if you care) 
whether the new object was added. So if the add() 
method returns false, you know the new object was a 
dupbcate of something already in the set. 




Object ^c^'rt tkrym^ 
-to add runs lis t'\i^\iO 

io kair> arid rtbitya -faru^- 



Oh\tti alvtadY If^ 
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overriding hashCode() and equa[s() 

The Song class with overridden 
hashCodeO and equalsd 



class Song implements Comparable<Song> | 
Scring tide; 

String artist; _ , / ^y^^ane e^" 

String racing; TVe ^^as^"^,, -^t aJ^Ve^r So«5- 

String bpm; ^ r.ei^^^ '^"^^ 

public boolean equals (Object aSong) { 
Song s = (Song) aSong; 
return getTitle ( ) . equals ( s . ge tTl tie ( ) ) 

} 

public int hashCode() 



_ ACf AT .tw. u thai m a St/.^ 



ic int haahCodeO { Sar^e d«al ho-«... th« S^;,, ,k , 

return title .hashCode () ^ ^as),CodeO »«e+k«J ^ , ' o^f»^idde« 



public int compareTo (Song s) f 

return title . compareTo (s.getTitleO ) 



) 



Song(String t, String String r, String b) { 
title ^ t; 
artist = a; 
rating = r; 
bpm = b; 

} 



public String getTitle () { 
return title; 

} 



public String getArtistO ( 
return artist; 

} 

public String getRatingO { 
return rating; 

} 

public String getBpmO { 
return bpm; 

] 

public String toStringO { 
return title; 

) 



Now it wo*-bf Ho 6vy\\C^ics when wc 
6all Sov-tO a^lN and ^\\cy\ wc put 

-Utf Av^avLiit into tVitf ttaiKSrt, tKc 
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[Pink Moon, Somersault, Shiva Moon, Circles, 
Deep Channel, Passenger, Listen, Listen, 
Listen, Circles] 



coilGctions with generics 



Java Object Law For HashCode() 
and equalsO 



The API docs for class Object state the 
rules you MUST follow: 



If two objects are equal, they MUST 
have matching hashcodes. 



If two objects are equal, calling 
equalsO on either object MUST return 
true. In other words, if (a.equals(b)) then 
(b-cquals(a)). 



If two objects have the same hashcode 
value, they are NOT required to be equal. 
But if they're equal, they MUST have the 
same hashcode value. 



' " So, if you override equals{), you MUST 
override hashCode(). 



The default behavior of hashCode() 
vs to generate a unique integer for each 
object on the heap. So if you don't override 
hashCodeO in a class, no two objects of 
that type can EVER be considered equal. 



The default behavior of equalsO is to 
do an comparison. In other words, to 
test whether the two references refer to a 
single object on the heap. So if you don't 
override equalsO in a class, no two objects 
can EVER be considered equal since 
references to two different objects will 
always contain a different bit pattern. 

a*equals(b) must also mean that 
a,hashCodB() == b.hashCode() 

But a.hashCodeO == b.hashCodeO 
does NOT have to mean a,equals(b) 



How come hashcodes can be the same 
even If objects aren't equat? 

A- 

HashSets use hashcodes to store the ele- 
ments in a way that makes it much faster to access. 
If you try to find an object in an ArrayList by giving 
the ArfayList a copy of the objea (as opposed to 
an index value), the ArrayList has to start searching 
from the beginning, looking at each element In 
the list to see if it matches. But a HashSet can find 
an object much more quickly, because ft uses the 
hashcode as a kind of label on the ''bucket" where 
It stored the element. So if you say/l want you 
to find an object in the set that's exactly like this 
one..." the HashSet gets the hashcode value from 
the copy of the Song you give it (say. 742), and 
then the HashSet says/Oh, I know exactly where 
the object with hashcode #742 is stored..." and it 
goes right to the #742 bucket. 

This isn't the whole story you get in a computer 
science class, but it's enough for you to use Hash- 
Sets effectively. In reality, developing a good hash- 
code algorithm is the subject of many a PhO thesis, 
and more than we want to cover In this book. 

The point Is that hashcodes can be the same 
without necessarily guaranteeing that the objects 
are epual, because the'hashlng algorithm" used in 
the hashCodeO method might happen to return 
the same value for multiple objects. And yes, that 
means that multiple objects would all land in the 
same bucket in the HashSet (because each bucket 
represents a single hashcode value), but that's not 
the end of the world. It might mean that the Hash- 
Set is Just a little less efficient (or that it's filled 
with an extremely large number of elements), but 
if the HashSet finds more than one object in the 
same hashcode bucket, the HashSet will simply 
use the equalsO method to see If there's a perfect 
match. In other words, hashcode values are some- 
times used to narrow down the search, but to find 
the one exact match, the HashSet still has to take 
all the objects in that one bucket (the bucket for 
ail objects with the same hashcode) and then call 
equalsO on them to see if the object it's looking for 
is In thai bucket. 
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TreeSets and sorting 



And (f we want the set to stay 
sorted, weVe got TreeSet 

TreeSet is similar to HashSet in that it prevents duplicates. But it also keeps the list sorted. It works 
just like the sort() method in that if you make a TreeSet using the set's no-arg constructor, the 
TreeSet uses each object's compareTo() method for the sort. But you have the option of passing 
a Comparator to the TreeSet constructor, to have the TreeSet use that instead. The downside to 
TreeSet is that if you don't need sorting, you're still paying for it with a small performance hit. But 
you'll probably find that the hit is almost impossible to notice for most apps. 

import java.util.*; 
import j ava . io . * ; 
public class JukeboxS { 

ArrayList<Song> songList ^ new ArrayList<Song> {) ; 

int val; 



public static void main (String [ ] args) { 
new JukeboxS (). go 0 ; 

public void goO { Instant^aU ^ "^^"^^^^^ 

getSongs 0 ; CalH^\t\T3 ^^e tV.e ^^^^^^ 

System. out. println (songList) ; X v^^ed^s tbe sort^ 

Collections, sort (songList) ; / to*«^aveToC^ wC^ ^^^) 

System. out. println (songList) ; ^ y^^^ ^^%%td< ^ Cow^?^^ 

TreeSet<Song> songSet = new TreeSet<Song>() ; 
songSet. addAll (songList) ; 

System. out. println (songSet) ; '^^l a ^''^'^ HashSct 

md.v,du^lly using so^jSeiaddO M 
void getSongs ( ) { added songs io ihc y^v^^ayLisi) 

try { ^ 
File file - new File {"SongListMore . txt") ; 

Buf f eredReader reader ^ new Buff eredReader (new FileReader (file) ) ; 
String line ^ null; 

while ( (line^ reader , readLine () ) null) { 
addSong (line) ; 

1 



} catch (Exception ex) { 
ex . printStackTrace ( ) ; 

} 

} 



void addSong (String lineToParse) { 

String!] tokens = lineToParse . split ( 'V" ) ; 

Song nextSong ^ new Song (tokens [ 0] /• tokens[l]^ tokens[2], tokens[3]); 
songList . add (nextSong) ; 

1 

) 



collections with generics 

What you MUST know about TreeSet... 



TreeSet looks easy, but make sure you reaJly understand what you need to 
do to use it We thought it was so important that we made it an exercise so 
you*d have to think about it. Do NOT turn the page undl you've done this. 
We mean it. 



4^^pen your pencil 



Look at this code. 
Read it carefully, then 
answer the questions 
beiow. (Note: there 
are no syntax errors 
in this code.) 



import java.util.*; 

public class TastTree { 

public static void main (St:rlng(] args) { 
new Tea tTree ( ) . go ( ) ; 

} 

public void go() { 

Book bl = new Baok('^How Cats Work") ; 
Book b2 = n^w Book ("Remix your Body") ; 
Book b3 = now Book (""Finding Emo") ; 



TreeSet<Book> tree = new TreeSet<Book>() ; 

tree. Add (bl) ; 

tree . add (b2 ) ; 

tree. add (b3) ; 

System. out .println (tree) ; 

} 



class Book ( 

String tditle; 
public Book (String t) { 
title = t; 

) 



D.What Is the result when you compile this code? 



2). If it compiles, what Is the result when you run theTestTree class? 



3). If there is a problem (either complle-tlme or runtime) with this code, how would you fix It? 
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how TreeSets sort 



TrecSet elements MUST be comparable 

TreeSet can't read the programmer's mind to figure out how the 
object's should be sorted. You have to tell the TreeSet how. 

To use a TreeSet, one of these 
things must be true: 

y The elements in 

the list must be of a type that 
Implements Comparable 



The Book class on the previous 
page didn't implement Comparable, so it 
wouldn't work at runtime. Think about it, the 
poor TreeSef s sole purpose in life is to keep 
your elements sorted, and once agairv— it had 
no idea how to sort Book objects! It doesn't fail 
at compile-time, because the TreeSet add() 
method doesn't take a Comparable type.The 
TreeSet add() method takes whatever type 
you used when you created the TreeSet. In 
other words, if you say new TreeSet<Book>() 
the add() method is essentially add(Book). And 
there's no requirement that the Book class 
implement Comparable! But it fails at runtime 
when you add the second element to the set. 
That's the first time the set tries to call one of 
the objecfs compareToQ methods and... can't. 



OR 



y You use the TreeSet's 
overloaded constructor 
that takes a Comparator 

TreeSet works a lot like the sort() 
method— you have a choice of using the 
element's compareTo() method, assuming 
the element type implemented the 
Comparable interface, OR you can use 
a custom Comparator that knows how 
to sort the elements in the set. To use a 
custom Comparator, you call the TreeSet 
constructor that takes a Comparator. 



class Book in5>lements Comparable { 

String titled- 
public Book (String t) { 
title - t; 

} 

public int compareTo (Object b) { 
Book book = (Book) b; 
return (title . compareTo (book . title) ) ; 

} 



public class BookCompare implements Comparator<Book> { 
public int con^are(Book one. Book two) { 
return (one . title . compareTo (two . title) ) ; 



} 



} 



class Test { 

public void go ( ) { 

Book bl = new Book ('"How Cats Work") ; 

Book b2 = new Book (''Remix your Body"); 

Book b3 ^ new Book (''Finding Emo") ; 

BookConpare bCompare = new BookConpare ( ) ; 

TreeSet<Book> tree = new TreeSet<Book> (bCompare) ; 

tree.add(new Book("How Cats Work"); 

tree, add (new Book ('^Finding Emo"); 

tree.add{new Book("Remix your Body"); 

System. out. println (tree) ; 

} ^ 
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WeVe seen Lists and Sets, now well use a Map 

Lists and Sets are great, but sometimes a Map is the best collection (not Collection 
with a capital "C" — remember that Maps are part of Java collections but they don*t 
implement the Collection interface). 

Imagine you want a collection that acts like a property list, where you give it a name 
and it gives you back the value associated with that name. Although keys will often be 
Strings^ they can be any Java object (or, through autoboxing, a primitive). 



value 



«Ball1» 


«Ball2" 


"Ball3» 


"Ball4 



Map 



Each element in a Map is actually 
TWO objects— a key and a vafue. 

I You can have duplicate values^ but 
NOT duplicate keys. 



Map example 

iraport java . util . 



public class TestMap \ 

public static void main (String[ ] args) ( 

HashMap<String, Integer> scores = new HaahMap<String, Integer>(); 



TWO typ. pa.a.e W 
for key and ore U 



scores. put C'Ka thy", 42); 
scores, put (''Bert", 343); 
scoras.put ("Skyler", 420); 



It takes tv^i, dirgur-enb fk«y, valu«). 



t.O\i>rie 



System. out.princln (scores) ; 

System. out.crintln (seoras.get ("Bert") ); TL i/\ 

'jtn.Or.ei}^cdii\ieiakey,s>^d 
vftut^ value CiY, tKli 



I Fit Edii Wnacw Mdp WiaroAmi 



- U-a.«{} i«i«d tK. k^a^kei. f J y^ 

vlien y«, print l\tU ahd ^U. ' 



%java TestMap 

{Skyler=420, Bert=343, Kathy=42} 
343 
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If a method argument is an arr^y 
of Animals, it will also take an 
array of any Animal subtype. 

In other words, if a method is 
declared as: 

void foo(Animaltl a){) 

Assuming Dog extends Animal, 
you are free to call both: 

foo(BnAmmalArray); 
fco(aDogArray); 



generic types 

Finally^ back to generics 

Remember earlier in the chapter we talked about how methods 
that take arguments with generic types can be.., weird. And we 
mean weird in the polymorphic sense. If things stan to feel 
strange here> just keep going — it takes a few pages to really tell 
Lhe whole sioty 

We*ll start with a reminder on how array zr gum tnts work, 
polymorphically, and then look at doing the same thing with 
generic lists. The code below compiles and runs without errors: 

Here's how It works with regular arrays; 



import java . util . 

public class TestGenericsl { 

public static void main (String f ] args) { 
new TestGenericsl () .go 0 ; 

^^^^ ^o\^ botK dog. 3y,d tais, 

public void go() { 

Animal [] animals = (naw Dag() , new Cat{) , new Dog() }; 
DogI] dogs = {new Dog() , new Dog () , new Dcg() }; 

takeAnimals (animals) ; Declare and trtaii a Dog a>rray, 

taJceAnimals (dogs) ; ^ ^aH ^akc/W»im^UO, ujin^ \^ tKat ^o\ds. only Do^ ^iKc tom^il^v- 



public void takeAnimala (Animal { ] animals) 
for (Animal a: animals) { 



a.eat () 



{ 



} 




wo>%'-t Irt you put a Ca-t 



abstxact class Animal ( 
void 6&t{) { 

System, out. println C'animAl eating"); 

} 

) 

class Dog extends Animal ( 



void bark 0 ( 1 nc Wp|i^i,d da« hic.a.dhy. 



1 

class Cat extends Animal { 
void meow ( ) ( } 

} 
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Using polymorphic argumcHts and generics 

So we saw how the whole thing worked with arrays, but will it work 
the same way when we switch from an array to an ArrayList? Sounds 
reasonable, doesn't it? 

First, let's try it with only the Animal ArrayList. We made just a few 
changes to the go() method: 



Passing In just Array List < An! ma l> 

public void go () { 
ArraYLiat<Ai 

^nxKials . add (n 
animals . add (n 
animals -add (new DogO) 



Asi^^pl^ ^hdhjt (tor. AvNimjlG^ 

voia go () { 

ArraYLiat<Aniinal> animals - new AxrayLis t<An i mn 1 > ( ) ; 

anirrials . add (new DocrO); 

animals . add (new Cat () ) ; ^ Wt Kavf ii 3 fc^, 1. . 

"Ko^ut .y.i,, , ^^^y ^^^^ 

takaArmaals (ani^ls) ; Thi. .s ihe 



public void t&XaAnunals (ArrayList<Animal> animals) 

for (Animal a: animals) ( 



1 



/. ^ w.-^ c^crrainft CISC is 

'.''T ^^^^ i«>-pV*^x 



Compiles and runs just fine 



%java TestGenerics2 

animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
animal eating 
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Pot will It work with ArrayU8t<Pog> ? 

Because of polymorphism, the compiler let us pass a Dog array 
to a method ^viih an AnimaJ array argument. No problem. And 
an ArrayUst<:Animal> can be passed to a method with an 
ArTayList<Animal> argument So the big quesdon is, will the 
ArrayList<Animal> argument accept an ArTayLisi<Dog>? If it works 
with arrays, shouldn't it work here too? 



Passing in Just ArrayList<Dog> 



public void go ( ) ( 

Array^List<Animal> animals 
animals . add (new DogO); 
animal . add (new Can()}; 
aniiTials . add (new DogO); 

takeAnimals (animals) ; 



= new ArrayList<i\nimal> 0 ; 



ArrayList<Dog> dogs = new ArraYList<Dog>() ; 

dogs , add (new DogO); a^jiIk* ^ r) . , 

dogs . add (new Dog ( ) ) ; ' ' ^''^^''^ P^^ ^ -^-pU 

takeAnimals (dogs) ; ^ j,,, tK. ..w ^hai w. .h.n,.d 



public void takeAnimals (ArrayLi8t<Aniiiial> animals) ( 

for (Animal a : animals) ( 
a . eat ( ) ; 

} 



When we compile It: 

I F\ie Ettit Window Ht\p CatiAwSnwWf 



%java TestGenerics3 



TestGenerics3 . java : 21 : takeAnimals (java . util , 
ArrayList<Animal>) in TestGenerics3 cannot be applied to 
( j ava . u ti 1 . Ar rayLis t<Dog> ) 
takeAnimals (dogs) ; 

1 error 



\i looked u> Hjhi, 

but went so x^ohj,. 
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And Tm supposed to be OK with thi5? That 
totally scm\A^s my animal simufation where the 
veterinary progrom takes a list of any type of 
animal, so that c dog kennel can send a list of dogs, 
and a cot kennel can send a list of cots,., now 
you're saying I con't do thot if I use collections 
rnsteod of arrays? 



What could happen if it were allowed... 

Imagine the compiler let you get away with that. It let you pass an 
AjTayUst<Dog> to a method declared as; 

public void takeAnimals (ArrayList:<Animal> animals) ( 
for (Animal a: anirnals) { 
a .eat 0 ; 



} 



There's nothing in that method that boks harnrLful, right? After all^ 
the whole point of polymoiphism is that anything an Axiimal can 
do (in this case, tl^e eat() method)^ a Dog can do as well. So what's 
the problem with having the method cal) eat() on each of tlie Dog 
references? 

Nothing. Nothing at all. 

There *s nothing wrong ^^Ath that cod^. But imagine this code instead: 



public void takeAnimals (ArrayList<Animal> animals) ( 

animals. add (new Cat() ) ; 



/ikcsll ^Vc just sWk a Cat in v^^at 



So that's the problem. There's certainly nothing wrong with adding a 
Cat to an ArrayUst<Ajiimal>, and that's the whole point of having an 
ArrayLisi of a supercype like Animal — so that you can put all types of 
animals in a single Animal ArrayList. 

But if you passed a Dog ArrayList — one meant to hold ONLY Dogs — 
to this tnethod that takes an Animal ArrayList, then suddenly you'd 
end up with a Cat in the Dog list. The compiler knows that if it lets 
you pass a Dog ArrayList into the method like diat, someone could, 
at rundme, add a Cat to your Dog list. So instead, die compiler jtist 
won't let you take the risk. 

If you declare a method to take ArrayList <Animal> it can take ONLY an 
ArrayList <Animal>f not Array Lisi<Dog> or ArrayLisi<Cat>. 
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arrays vs. ArrayLists 



Wo/t a minute... if this is why they won't let 
you pass a bog ArrayList into o method that 
takes an Animal ArrayList— to stop you from 
possibly putting a Cat in what was actually a Dog list, 
' then why does it work with arrays? Don't you have 
the same problem with arrays? Can't you still odd 
o Cat object to a Dog[] 7 




Array types are checked again at 
runtime ^ but collection type checks 
happen only when you compile 

Let's say you do add a Cat to an array declared as Dog[] (an array dial 
was passed into a mediod argument declared as Anima)[], which is a 
perfecdy legal assignment for arrays). 

public void go() { 

Dog[] dogs = {new Dog() , new Dog() , new DogO); 
takeAnlioals (de>gs) ; 

) 

public void taJceAnimals (Animal [] aniynals) ( 
animals [0] = new Cat() ; 

} ^ f a ^cw Cat into 5 D05 a^rray. The 

dcnipileyr allovyed it because ii knows tKat 
you mi^ht hav^ passed a Cat a^rray ov A^mal 
ar^ay -to {Mc ^netKod, so to tKc Compiler it 
was possible that tbis was 0^- 



It compiles, but when we run it: 



File £(]ill Wtndov H«t» CstsAroSmaiW 



%3ava TestGenericsl ^ — - , , 

Exception in thread '^main" java»laj^{f?ArrayStoreException; 

Cat ^ 

at TestGenericsl , takeAnimals (TestGenericsl . java : 16) 
at TestGenericsl , go (TestGenericsl. java: 12) 
at TestGenericsl .main (TestGenericsl . java: 5) 
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Wouldn't it be dreamy If there were 
Q way to still use polymorphic collection 
types as method arguments, so that my 
veterinary program could take bog lists 
and Cat lists? That way I could loop through 
the lists and call their ImmunizeQ method, 
but it would still have to be safe so that you 
couldn't add a Cat in to the bog list. But I 
guess that's just a fantasy... 



generic wildcards 

Wildcards to the rescue 

It looks unusual, but there is a w'ay to create a method argument that 
can accept an ArrayList of any Animal subtype. The simplest \vay is to 
use a wildcard — added to the Java language explicidy for this reason. 



public void takeAnimals (ArrayLi3t:<? extends Aniinal> animals) 
for(Ariimal a: animals) ( 
a. eat 0 ; 



} 



So now you're wondering^ '"Whales the difference? Don't you have 
die same problem as before? The method above isn't doing 
anything dangerotis — calling a method any Animal subtype is 
guaranteed lo have — but can*t someone still change this to add a 
Cat to the anim/ds list, even though it's really an ArrayLi&t<Dog>? 
And since it's not checked again at runtime, how is this any 
different from declaring it without the wildcard?"* 

And you'd be right for wondering. The answer is NO. When you 
use the wildcard <?> in your declaration, the compiler won't let 
you do anything that adds to the list! 



^zrt rre^ts eiiKcir e^iehd s OR 
\m^\t*ri^r^i^ dtf^yid'\r\0^ on -tKc 

ty^TScHr you wan-t to take 
Av^ayList tyf tVtdt 
iwvplcw^eint {he: Pet intev'-Pacej 
y<^'d du\^Yt it as: 



When you use a wildcard in your method 
argument, the compiler will STOP you from doing 
anything that could hurt the list referenced by the 
method parameter. 

You can still invoke methods on the elements in 
the list, but you cannot add elements to the list. 

In other words, you can do things with the list 
elements, but you can't put new things in the list. 
So youVe safe at runtime, because the compiler 
won't let you do anything that might be horrible at 
runtime. 

So, this is OK inside takeAnimals(): 



But THIS would not compile: 

.iij i ] . J i i ( I.. ■ " ; I J M ; 
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Alternate syntax for doing the same thing 

You probably remember that when we looked at the sort() method, 
it used a generic type, but with an unusual format where the type 
parameter was declared before the return type. It's just a different way 
of declaring the type parameter, but the results are the same: 

This: 

public <T extends Animal> void takeThing(ArrayList<T> list) 

Does the same thing as this: 

public void takeThing (ArrayList<? extends Animal> list) 

DuBl^tJuestiPns 

If they both do the same thing, why would you use 
one over the other? 

A- 

It all depends on whether you want to use "V'some- 
where else. For exannple, what if you want the method to 
have two arguments—both of which are lists of a type that 
extend Animal? In that case, it's more efficient to just declare 
the type parameter once: 

public <T extends Aniinal> void takeThing (ArrayList<T> one, ArraYList<T> two) 
instead of typing: 

public void takeThing (ArrayList<? extends Aniinal> one, 

ArrayList<? extends Animal> two) 
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be the compiler exercise 




BE f^le compiler, advanced 

Your job [s to play compiler and determine which of 
these statements would compile. But some of this 
code wasn't covered in the chapter, so you need to 
work out the answers based on what you DID learn, 
applying the''rules"to these new situations. In 
some cases, you might have to guess, but the 
point is to come up with a reasonable answer 
based on what you know so far. 

(Note: assume that this code is within a legal ciass and 
method.) 



CDtnptles? 

Q ArrayList<Dog> dogsl = new ArraYLi3t<Animal> ( ) ; 
Q Arraylii8t<2^inial> ani_malsl = new ArrayList<Dog>() ; 
1 \ L±flt<Animal> list = new ArrayList<Animal> ( ) ; 
I I ArravList<Doq> dogs = new ArrayList<Dog> () ; 
I I ArrayLigt<AniiDal> animals = dogs ; 
I i Iiist<Dog> dogList = dogs; 

I I ArravList<Obiect> objects = new ArrayLiat<0bj6ct> () ; 

[~1 Liat<Object> objLiat - objects; 

I \ ArravLlst<Obiect> objs = new ArrayList<Dog>() ; 
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public class SortMountains { 



import javo.Util.*; 



Etigrneei^ ^vom 



LinkedList< Mountain > mtn = new LinkedList<Mountain> ( ) ; 

class Namecompare Implements Comparator < Mountain > { 

public int compare (Mountain one. Mountain two) { 

return one . name . compareTo(two . name) ; 

} 

} 

class Beightcompare Jmplcments Comparator <MountaJn> { 

public int compare (Mountain one. Mountain two) { 

return (two. height - one. height); 

> 



public void go( ) { 

mtn.add(new Mountain ( "Longs" ^ 14255)); 
mtn.add(new Mountain | "Elbert" , 14433)); 
mtn.add(new Mountain ( "Maroon" , 14156) ) ; 
mtn.add(new Mountain ( "Castle" , 14265)); 

Systein*out-println( "as enteredAn" + mtn); 
NameCompare no = new NameCompare ( ) ; 

Collect ions. sort(mtn, nc); 

System. out-println( "by nametVn" + mtn); 
HeightCompare he = new HeightCompare ( ) ; 

Collections, sort(mtn, he); 

System.out .println( "by heighten" + mtn); 

} 

} 

class Mountain { 
String name; Output: 



> 

public static void main(String (] args) { 



new SortMountain( ) »go( ) ; 

> 




fnt height; 



Rie Edit Window Help ThteOne'sFofSob 



1 



public String to5tring( ) { 
return name + " " * height; 

> 



Mountaln(String n, Int h) { 
name = n; 
height = h; 



} 
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flH-in-the-blank solution 



Possible Answers: 

Comparator, 
Comparable, 
compareTo( 
compare( ), 

yes, 

no 



Given the foUowing compilable statement: 

Collectionfli . sort (myArrayList) ; 

1. What must the class of the objects stored in myArrayList implement? Comparable 

2. What method must the class of the objects stored in myArrayList implement? CompareTo( ) 

S. Can the class of the objects stored in myArrayList implement both 

Comparator AND Comparable? yes 



Given the following compilable statement: 

Collections. sort (myArrayList, myCon^are) ; 

4. Can the class of the objects stored in myArrayList implement Comparable? yes 

5. Can the class of the objects stored in myArrayList implement Comparator? yes 

6. Must the class of the objects stored in myArrayList implement Comparable? no 

7. Must the class of the objects stored in myArrayList implement Comparator ? M 

8. What must the class of the myCompare object implement? Compcr^or 

9. What method must the class of the myCompare object implement? Conipare( ) 
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BE com^flex aolutfem 



Compiles? 

Q ArrayList<Dog> dogsl = new ArrayList<Aiiimal>() ; 
Q ArrayList<Animal> animalsl = new ArrayList<Dog> () ; 

List<Aniiaal> list = new ArrayLiat<Aniinal>() ; 
I i ArrayU-flt<Doq> dogs = new ArrayList<Dog> ( ) ; 
Q ArrayList<Aniiiial> animals = dogs; 
List<Dog> dogLiat = dogs; 

ArrayList<Objact> objects = new ArrayList<Qbject>() ; 
List<Qbjact> objList = objects; 
I \ ArrayLi3t<0bject> objs = new ArrayList<Dog>() ; 
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17 package, Jars and deployment 

Release Your Code 




It's time to let go. You wrote your code. You tested your code. You refined your code. 
You told everyone you know that if you never saw a line of code again, thafd be fine, But in the 
end, you've created a work of art. The thing actually runs! But now what? How do you give It to 
end users? Who^ exactly do you give to end users? What if you don't even know who your end 
users are? In these final two chapters, we'll explore how to organize, package^ and deploy your 
Java code. We'll look at local, sefni-!ocal,and remote deploynnent options including executable 
jars, Java Web Start, RMi,and Servlets.ln this chapter, we'll spend n^ost of our tlnne on organizing 
and packaging your code— things you'll need to know regardless of your ultinnate deployment 
choice. In the final chapter, we'll finish with one of the coolest things you can do In Java. Relax. 
Releasing your code Is not saying goodbye. There's always maintenance,,. 
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deploying your applicatioh 

Wliat exactly a Java application? In other words, 
once you're done with development, what is it that you 
deliver? Chances are, your end-users don't have a system 
identical to yours. More importandy, they don't have your 
application. So now it's time to get your program in shape 
for deployment into The Outside World. In this chapter, 
we'll look at local deployments, including Executable Jars 
and the part-local/part-remote technology called Java Web 
StarL In the next chapter^ we'll look at the more remote 
deployment options, including RMI and Servlets. 

Deployment options 





m i 










Executable 
Jar 


Wfe^^.<. r r BWmi ril l 1 





100% Ucal 



Combination 



100% Remote 



^ Loco) 

The entire application runs on the 
end-ii5er'5 computer, as a stand-alone, 
probably GUI, program, deployed as 
an execLTTable JAR (well look at JAR 
in a few pages,) 

Combination of local and remote 

The application is distributed with a 
client portion n^nning on the user's 
local system, connected to a server 
where other parts of the application 
are rummg. 

@> Remote 

The entire Java application runs on a 
server system, with the client accessmg 
the system through some non-Java 
means, probably a web browser. 

But before we really gel into the whole deployment thing, 
lei*s take a step back and look at what happens when you've 
finished programming your app and you simply want to pull 
out the class files to give them to an end-user What's really 
in that working directory? 



A Java program is a hmck 

of classes. That's 

output of your development. 

TTie real ^estion is 
to do widi lliose classes 
when you're done. 




Brain Barbell 



What are the advantages and 
disadvantages of delivering your 
Java progrann as a local, stand- 
alone application running on 
the end-user's computer? 

What are the adva ntages and 
disadvantages of delivering your 
Java program as web-based 
system where the user interacts 
with a web browser, and the 
Java code runs as servlets on the 
server? 
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IvMagine this scenario... 



Bob's happily at work on the final pieces of his cool new 
Java program. After weeks of being in the "I'm-just- 
one<ompile-away" mode, this time he's really 
done. The program is a fairly sophisticated 
GUI app, but since the bulk of it is Swing 
code, he*s made only nine classes of his 
own. 

At last, it's time to deliver the program to the 
client. He figures all he has to do is copy the 
nine class files, since the client already has 
the Java API installed. He starts by doing an 
Is on the directory where all his files are... 




Whoal Something strange has happened. Instead of 18 
files (nine soiu-ce code files and nine compiled class 
files), he sees 31 files, many of which have very strajige 
names like: 

AccountSFilelistener.class 

Chart$SaveListener class 

and on it goes. He bad completely forgotten 
that the compiler has to generate class files 
for all those inner class GUI event listeners 
he made, and that's what all the strangel)^ 
named classes are. 

Now he has to carefiiUy extract all the class 
files he needs. If he leaves even one of them out, 
his program won't work. But it's tricky since he 
doesn't want to accidentally send the client 
one of his source cod^ files, yet everything is 
in the same directory in one big mess. 
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Separate source code and class files 

A single directory with a pile of source code and class files is a 
mess. It mms out, Bob should have been organizing his files 
from the beginning, keeping the source code and compiled 
code separate. In odier words, making sure his compiled class 
files didn't Jand in the same directory as his source code. 

The key is a combirurtzan of directory structure organization and the 
-d compiler option. 

There are dozens of ways you can organize your ftles, and your 
company might have a specific way they want you to do it We 
recommend an organizational scheme that's become almost 
standard, though. 

With this scheme, you create a project directory, and inside 
that you create a directory called source and a directory called 
classes, You start by saving your source code (Java files) into 
the source directory, Then the trick is to compile your code 
in such a way that the output (the .class files) ends up in the 
classes directory. 

And there's a nice compiler flag, -d, that lets you do that 




Compiling with the -d (directory) flag 



MyApp . j ava 

\ 



Ac 



%cd MyProject/source 
% J avac "■ciHBH^^nR 

, dow« ajji^ ^^^^ ^ 

By using the -d flag, you get to decide which directory the 
compiled code lands in, rather than accepting the default of 
class files landing in the same directory as the source code 
To compile all the .Java files in the source directory, use: 

%javaG -d . ./classes 



Running your code 

%cd MyProject/classes 
%java Mini '^^a 



* . 3ava 

\. *.java domfiUs A^-^ 



MyApp.cla&s 




MyApp.Java 
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your Java in a JAR 



AJAR file is a Java ARchive. It*s based on the pkzip file format, and it lets you bundle 
all your classes so that instead of presenting your client with 28 class files, you hand 
overjust a single JAR file. If you're familiar with the lar command on UNIX* you'U 
recognize the jar tool commands. (Note: when we say JAR in all caps, we're referring 
to the archive fiU, When we use lowercase, weVe referring to xhtjar toolyou use to 
create JAR files.) 

The question is, what does the client dovn\h d^eJAR? How do you get it to rwtz? 
You make the JAR executable. 

An executable JAR means the end-user doesn't have to pull the class files out before 
running the program. The user can run the app while the class files are stiU in the 
JAR The trick is to create a man^est^ty that goes in the JAR and holds information 
about the files in the JAR To make a JAR executable, the manifest must tell the JVM 
whick class has the mainQ method! 



Making an executable JAR 

0 Make sure all of your class files are 
the classes directory 

We're qo\r\q to refine thfs in q few pages, but 
for now, keep qI) your class fi/es sitting in the 
directory named 'dosses'. 



in 




IDllOl 



IS 



lOLd 16 « 



MyApp.dass 



Create a manifest.txt file that states 

which c\q!&^ has the malnQ method 

Make a text file named manifest.txt that has a 
one fine: 

Press the return key after typing the Main- 
C\q&& line, or your manifest may not work 
correctly. Put the manifest file into the "classes" 
directory. 



Run the Jar tool to create a JAR file 
that contains everything in the classes 
directory, plus the manifest. 

%cd MiniProject/claaaes 

%jar -cvmf ttAnifaat , txt Appl.jar *.cla8a 
OR 

%jar -cvmf manifest . txt appl.jar MyApp. class 




manifesLM 





appl-Jop 



manlfesLtxt 



\r. t^C JAR 
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Combination 



100% Remote 



Most 100% local Java 
apfs are deployed as 
execirtablejM files. 



Iluhhihg (executing] the MR 

Java (the JVM) is capable of loading a class from a JAR, and calling 
the majn() method of that class. In fact, the entire application can 
stay in the JAR. Once the bail is rolling (i.e., the mainO toethod 
starts running), the JVM doesn't care whert your classes come 
from, as long as it can find them. And one of the places the JVM 
looks is%vithin any JAR files in the classpath. If it can seeaJAR, the 
JVM will look in that JAR when it needs to find and load a class. 



%cd MyProjact/classes 



(ipf>l.Jor 



M ho mike So^y v-orkmg diTitt^ 

- iKe flat* where ^^'^ 




Depending on how your operating system is configured, you 
might even be able to simply double-click the JAR file to launch 
it. This works on most flavors of Windows, and Mac OS X. You 
can tisually make this happen by selecting the JAR and telling 
the OS to "Open with...** (or whatever the equivalent is on your 
operating system) . 



Why can't I just JAR up an entire directory? 

-^V* "rhe JVM looks inside the JAR and expects to find 
what It needs right there. It won't go digging into other 
dlrectories,unlGS5 the class Is part of a package.and even 
ther) the JVM looks only in the directories that match the 
package statement? 



t^iinl^^uestaons 

What did you Just say? 



A: 



You can't put your class files Into some arbitrary 
directory and JAR them up that way. But if your classes 
belong to packages^you can JAR up the entire package 
directory structure. In fact, you musf. We'll eyplain all this on 
the next page, so you can relax. 
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Put your classes m packages! 

So you've written some nicely reusable class fiJes, and you've 
posted them in your internal development library for other 
programmers to use. While basking in the glow of having 
just delivered some of the (in your humble opinion) best 
examples of OO ever conceived, you get a phone call. A 
frandc one. Two of your classes have the same name as 
the classes Fred just delivered to the library. And all hell is 
breaking loose out there, as naming collisions and ambiguities 
bring development to its knees. 

And all because you didn't use packages! Well, you did use 
packages, in the sense of using classes in the Java API that are, 
of course, in packages. But you didn't put your own classes 
into packages, and in the Real World, that's Really Bad, 

We're going to modify the organizational structure from the 
previous pages Just a little, to put classes into a package, and 
to JAR the entire package. Pay very close attention to the 
subtle and picky details. Even the tiniest deviation can stop 
your code from compiling and/ or nmning. 

Paekages prevent class hatite coHflicts 

Although packages aren'tjust for prevendung name collisions, 
that*s a key feature. You might write a class named Customer 
2md a class named Account and a class named ShoppingCart 
And what do you know, half of all developers working in 
enterprise e-commerce have probably written classes with 
those names. In an OO world, that's ju3t dangerous. If part of 
the point of OO is to write reusable components, developers 
need to be able to piece together components from a 
variety of sources, and build something new out of them. 
Your components have to be able to 'play well with others', 
including those you didn*t write or even know about. 

Remember way back in chapter 6 when we discussed how 
a package name is like the full name of a class, technically 
known as the fully-q-mlified name. Class ArrayList is really 
jaz}a.utiLAxrayList, JButton is really javax.swingJButt(m^ and 
Socket is v^My jcaja^netSodiet Notice that two of those classes, 
ArrayList and Socket, both have jai/a as their *'first name". 
In other words, the first pan of their fully-qualified names 
is "java". Think of a hierarchy when you think of package 
structures, and organize your classes accordingly 




Package structure of the Java API for: 
Java text. NumberFormot 

jQvautil.ArrayLi^ 

java.Qwt.FlowLoyout 

jQVQ.Qwt.event,ActionEvent 

jovQ.net.Socket 



java 



NumberFormat 








1»U>1 ^ 

iit 11 

in -.n 


tx) 1:1 

sM. i:l 




lit Ul w. 



Socket 



event 



A/rayUst nowLayoirt 



MM tn ii 

u 1»W 
] n I*: 

1*1 M\ IS\ 



ActionEvent 



What does this picture look Uke to 
you? Doesn't It look a whole tot like 
a directory hierarchy? 
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...so I finol/y settled on 
foo.bar.Heisenberg for my 
quantum baking class 




Preventing package name conflicts 

Putting your class in a package reduces t±ie chances of naming 
conflicts with other classes, but what's to stop two programmers 
from coming up with identical package names? In other words, 
what*s to stop two programmers, each with a class named Accotmt, 
from putting the class in a package named shopping.customers? 
Both classes, in that case, would 5/^// have the same name: 

shopping, customers Account 

Sim strongly suggests a package naming convention that greatly 
reduces that risk — prepend every class with your reverse domain 
name. Remember, domain names are guaranteed to be unique. 
TWo different guys can be named Bartholomew Simpson, but two 
different domains cannot be named doh.com, 



Packages can prevent name 
canfljctS, but only if you 
clioose apaclcage name 
iliat's guaranteed to be 
uni^. The best way to 
do fliat is to preCice your 
packages your reverse 
domain name- 

com.headfir5tbooks.Book 



t 



Reverse domain package names 



irsstjav^projects.Chart< — ^^^^ 



t^^^n add YO"*^ o«r^ar.*Jti<mai 



nam£, but adding d<«-.>,tjd-fi«tiavj 
"xarvs w« Kave -b wc^vy about Ik 
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You must put a class 
into a directory 
structure tliat matches 
tlie paclcage liierarcliy. 



It your class in a package: 



Choose a package name 

I W€t2. using com. headfirst Java os our 

' exOTpfe. The class name is PackageExercise, 

ic -he fully-qualffied name of the doss is now; 

coin . headfirst Java . PackogeExercise. 



a package stotcment in your class 

be the first statement in the source 
; fife, above any import statements. There 
I be only one pockage statement per source 
; file, so all classes fn a source file must 
m the same package. That includes inner 
of course. 



packaga com . headfixs t javii f 

isipor t j avax , swing , * ; 

piLiblic class PackageExercise { 
// life-altering code here 



up a motching directory structure 

j I" s not enough to say your class is in o pockage, 
[fcy merely putting a package statement in 
; code. Your c\qss isn't truly in a pockoge 
if you put the class in a matching directory 
*nicture. So, if the fully-qualified class name 
rv.headfirstjavaPackQgeExercise, you 
' put the PackageExercise source code in o 
ctory named hcadfirstjava, which must be in 
ectory named com, 

\ possible to compile without doing that, but 

US— it's not worth the other problems 
II have. Keep your source code in a director/ 
^S^ctyre that matches the packoge structure, 
\ youii avoid o ton of painful headoches down 
: road. 




PackageExerclse.class 



PackageExerclsd.Java 



Set up a matching directory structure for 
both the source and dosses trees. 
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Compiling and running witli paclcages 

When your class is in a package, it's a little trickier to compile and 
run. The main issue Ls that both the compiler and JVM have to be 
capable of finding your class and all of the other classes it uses. 
For the classes in the core API, that's never a problem. Java always 
knows where its own stuff is. But for your classes, the solution 
of compiling from the same directory where the source files are 
siroply won't work (or at least not reliably) . VJc guarantee, though, 
that if you follow the structure we describe on this page, you*ll be 
successful. There are other ways to do it, but this is the one we ve 
found the most reliable and the easiest to stick to. 



Compiling with the -d (directory) flag 



%cd l»^Proj act/ source 
% javac 



com/headfirst java/PacJcageSxarcise . java 



To compile all the java files in the com.headfirstjava 
package, use: 

% j avac -d . . /classes com/headfixs t j ava/ * , java 

/ 

^pi(«^^ ^^^^ 



Running your code 

%cd MyProject/classes 





louei ). 

]» 110 1' 

» 11 « 
csi i» 

OSl 01 



PackagaExerctsd.class 
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The -d flag is even cooler than we said 

I Compiling with the -d flag is wonderful because not only does it 
I let you send your compiled class files into a directory other than 
the one where the source fiJe is, but it also knows to put the class 
into the correct directory sunjctiue for the package the class is in. 

But it gets even better! 

. Let's say that you have a nice 
} directory structiu-e all set up for your 

source code. But you haven't set 

up a matching directory structure 
f for your classes directory. Not a 

problem! Compiling with 

^ tells the compiler to not 
t just put your classes into 

correct directory tree, but to 

the directories if they don't 



1^ the va^^S^ di^t^M ^^^^^ 
ir^laicsVoot d-.r.dWA;d '; 




PackageExercfse.Java 



The -ci flag tells the complfery 
^Put the class into Its package 
directory structure, using the 
class specKled after the -d as 
the root directory. But... If the 
directories arent there^ create 
them first and then put the class 
In the right placer 



packagejars and deployment 

Q^- I tried to cd into the 
directory where my main class 
was^ but now the JVM says It can't 
find my class! But it's right THERE 
In the current directoryl 

A- 

Once your class is in a 
package, you can't call it by its 
'short' name. You MUST specify, 
at the command-line, the fully- 
qualified name of the class whose 
mainO method you want to run. 
But since the fully-qualified name 
Includes the package structure, 
Java insists that the class be in a 
matching ^//recforystructufe.So if 
at the command-line you say: 

%java com. f oo-Book 

the JVM will look in its current 
directory (and the rest of its 
classpath), for a direaory named 
''com'^ It wilt not look for a dass 
named Book, until it has found 
a directory named ''com" with a 
directory Inside named ""fool Only 
then will the JVM accept that its 
found the correct Book class. If it 
finds a 8ooi< class anywhere else, 
it assumes the class isn't in the 
right structure, even if it is! The 
JVM won't for example, look back 
up the directory tree to say, "Oh, I 
can see that above us is a directory 
named com, so this must be the 
right package..." 
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Making an executable MR with packages 

When your class Is in a package, rht package directory structure 
must be inside the JAR! You can't just pop your classes in the 
JAK the way we did pre-packages. And you must be sure that you 
don't include any other directories above your package. The 
first directory of your package (usually com) must be the first 
directory within the JAR] If you were to accidentally include the 
directory above tht package (e.g. the "classes" directory), the JAR 
wouldn't work correcdy. 




Making an executable JAR 

^ Make sure all of your class files ore 
within the correct package structure, 
under the classes directory. 




mm 



Ml M 
Ml *\ 



Package£xerds8xlass 



Create a manifest.txt file that states 
whrch class has the mainQ method, 
and be sure to use the fully- qualified 
class namel 

Moke 0 text file ncmed mamf est.txt that has o 
single fine: 

Main-Class : com.headfirstjava . PackagaExdrciaa 
Put the manifest file into the classes drrectory 





■ 








Hi 




■ 


■ 



manffesttxt 




PackagAExATcEsAxlm 



Run the jar tool to create a JAR file 
that contains the package directories 
plus the manifest 

The only thing yau need to include is the "com* 
directory, and the entrre pockage (and all dosses) 
will go into the JAR. 

%cd MyProjact/claaaas 




pockEx.jflT 




%jar -cvmf manifAst . txt packEie,jar com 



P3ckag«Exerdft«.ciui 
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So where did the manifest file go? 

Why don't we look inside the JAR and find out? From the 
command-line, the jar tool can do more than just create and run a 
JAR. You can extract the contents of a JAR (just like 'unzipping' or 
'untaxring'). 

Imagine you've put the packEx jar into a directory named Skyler. 

jar commands for listing and extracting 

^ List the contents of a JAR 

% jar packKx.jar 



I FIte Edit w!ndov^^fl)p Picida 



% cd Skyler 

% jar -tf packEx.jar 

META-INF/ 

META-INF/MANIFEST.MF 
com/ 

com/headf irst java/ 
com/headf irst java/ 
PackageExercise . class 



Extract the contents of a JiAR (Le. uf\jar) 
% cd Skyler 
% jar i^OT packEx. jar 





MANIFEST.MP 




T 

j« the MtTA-IK? di^iUy a^d 
tor. dcrceto^Y dlredUv i^ ^o-" 




MANIFESt^F 



1 ui r 



PackageExerclse.class 

META-INF stands for 'meto 
information'. The jar too) crzafes 
the META-INF directory as 
well as the MANIFEST.MF file. 
It olso takes the contents of 
your monif est file, and puts it 
into the MANIFEST.MF file. So, 
your manifest file doesn't go into 
the JAR, but the contents of it 
are put into the 'real' monifest 
(MANIFEST.MF). 
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Given the package/directory structure in this 
picture, figure out what you should type at the 
command-line to compile, run, aeate a JAR, and 
execute a JAFl Assume we're using the standard 
where the package directory structure starts just 
below source and classes. In other words, the iource 
and classes directories are not part of the package. 

Compile: 

%cd sourca 

%javac 

Run: 

%cd 

%java 

Create a JAk 

%cd 

% 

Execute a JAR 

%cd 

% 

Bonus question: What's wrong with the package name? 




Foofclass Foofjava 
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What happens If you try 
to run an executable JAR, and 
the end-user doesn't have Java 
Installed? 

Nothing will run, sfnce 
without a JVM Java code can't 
run.The end-user must have Java 
Installed. 

How can I get Java 
installed on the end-uier's 
machine? 

Ideally, you can create a custom 
Installer and distribute It along 
with your application. Several 
companies offer Installer pro* 
grams ranging from simple to 
extremely powerfuLAri installer 
program could, for example, de- 
tect whether or not the end-user 
has an approproprlate version 
of Java Installed, and If not, 
install and configure Java before 
Installing your application, 
Installshield, InstallAnywhere, 
and DeployDirector all offer Java 
Installer solutions. 

Another cool thing about some 
of the Installer programs is that 
you can even make a deploy- 
ment CD-ROM that includes 
installers for all nr^ajor Java 
platforms, so,., one CD to rule 
them all. If the user's running on 
Solaris, for example, the Solaris 
version of Java is installed. On 
Windows, the Windows^ ver- 
sion^ etcJf you have the budget 
this is by far the easiest way for 
your end-users to get the right 
version of Java Installed and 
configured. 



BULUT POWW^ 



Organize your project so that your source code and class files are not in 
Ihe same directofy. 

A standard organization structure is to create a project difedory. and then 
put a source directory and a classes directory inside the project directory. 

Organizing your classes into packages prevents naming collisions with 
other classes, if you prepend your reverse domain name on to the front of 
a dass name. 

To put a class in a package, put a package statement at the top of the 
source code file, before any import statements: 
I^Aclcaga com. wickedly smart; 

To be in a package, a class must be in a directory structure tt)at exactly 
matches the package structure. For a class, com.\ftrfckedtysmarLFoo, 
the Foo class must be in a directory named wickedlysmart, which is in a 
directory named com. 

To make your compiled dass land in the correct package directory 
struc^re under the classes directory, use the -d compiler flag: 
% cd source 

%javac -d /classes oom/wicJcedlysmart/Foo. java 

To run your code, cd to the classes directory, and give the fully-qualified 
name of your dass: 

% cd classes 

% java com , wickedly smart . Foo 

You can bundle your classes into JAR (Java ARchive) files. JAR is based 
on the pkzip format. 

You can make an executable JAR file by putting a manifest Into the JAR 
that states which dass has the mafnQ method. To create a manifest file, 
make a text file with an entry like the following (for example): 

Main-Class : com. wickedly smart . Foo 

Be sure you hit the return key after typing the Main-Class line, or your 
manifest file may not work. 

To create a JAR file, type: 

jar -cvfm manifest, txt MyJar.jar com 

The entire package directory structure (and only the directories matching 
the package) must be immediately inside the JAR file. 

To run an executable JAR file, type: 
java -jar MyJar.jar 
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Executable JAR files 
are nice, birf wouldn't it be dreamy 
if there were a way to make a rich, stand- 
alone client GUI that could be distributed 
over the Web? So that you wouldn't have to 
press and distribute alJ those CD-ROMs. And 
woufdn't it be just wonderful if the program 
could automotically update itself, replacing 
just the pieces that changed? The clients 
would always be up-to-date, and you'd never 
hove to worry obout delivering new 
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100% Local 



100% Remote 



Java Web Start 



With Java Web StArt (JWS), your application is launched for the 
first time from a Web browser (get it? Web StarQ) but it runs as a 
stand-alone application (well, almosC), without the constraints of the 
browser. And once it*s downloaded to the end-user's machine (which 
happens the first time the user accesses the browser link that starts 
the download) » it stays there- 
Java Web Start is, among other things, a small Java program that lives 
on the client machine and works much like a browser plug-in (the 
way, say^ Adobe Acrobat Reader opens when your browser gets a .pdf 
file). This Java program is called the Java Web Start Tielper app', 
and its key purpose is to manage the downloading, updating, and 
launcliing (executing) of ^lourJWS apps. 

When JWS downloads your application (an executable JAR), it 
invokes the main() method for your app. After that, the end-user can 
launch your application directory from the JWS helper app wiikoui 
having to go back through the Web page Unk. 

But that's not the best part. The amazing thing about JWS is its 
ability to detect when even a small part of application (say, a single 
class file) has changed on the server, and — ^without any end-user 
intervention — download and integrate the updated code. 

There's still an issue, of course, like how does the end-user gi?/Java 
and Java Web Start? They need both— Java to rui^ the app, and Java 
Web Start (a small Java application itself) to handle retrieving and 
launching the app. But even Uial has been solved. You can set things 
up so that if your end-users don*t have JWS, they can download 
it from Sun, And if they A> have JWS, but their version of Java is 
out-o^date (because you've specified in yoiu-JWS app that you 
need a specific version of Java), the Java 2 Standard Edition can be 
downloaded to the end-user machine. 

Best of all, it's simple to use. You can serve up a JWS app much like 
any other type of Web resource such as a plain old HTML page or a 
JPEG image. You set up a Web (HTML) page with a link to your JWS 
application, and you're in business. 

In the end, your JWS application isn't much more than an 
executable JAR that end-users can download from the Web. 



End-users laimcK a Java 
Web Start app by cMing 
on a link in a Web 
page, Bttt once -flie app 
downloads, it runs outside 
tlie browser, just like any 
odier stand-alone Java 
application. Inte. a 
Java Web Start ^ is just 
an execfutable J^idiafs 
distributed over "die Web. 
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Java Web Start 



How Java Web Start works 

^ The client clicks on c Web page link 
to your JWS application (a .jnip file). 

The Web page link 

<a hr6f=''MyApp. jnlp">ClicJc</a> 




The Web server (HTTP) gets the 
request and sends back a JnIp file 
(thfs is NOT the JAR). 

The JnIp fiJc IS an XAAL document that 
states the name of the appfication s 
executoble JAR file. 




Java Web Start (a small 'helper opp' 
on the client) is started up by the 
browser. The JWS helper app reads 
the .JnIp file, and asks the server for 
the MyAppJar file. 




^ The Web server 'serves' up the 
requested .jar file. 




Java Web Start gets the JAR and 
starts the application by calling the 
specified main() method (just like an 
executable JAR), 

Next time the user wonts to run this app, he can 
open the Java Web Start applicatron and from 
there launch your app, without even being online. 
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package, jars and deployment 



The .Jnip file 



To make a Java Web Start app, you need to jnlp (Java Network 
Launch Protocol) file that describes your application. This is the 
file the JWS app reads and uses to find your JAR and launch the 
app (by calling the JAR's main() method). A jnlp file is a simple 
XML document that has several diJBFerent things you can put in, 
but as a minimum, it should look like this: 



oot 



<?xml version="1.0" encoding=s"utf-8''?> 



TVc ^^"^^ ^^^y ^€0 ^ Xot^^^^lTr, i'^ 



<jnlp spec="0.2 1.0" 

codebase="http : //127 . 
href ="MyApp . jnlp'> 



nested in so^e otKcr di^cdto^V 



<information> 

<title>kathy App</title> 
<vendor>Wickedly Smart</vendor> 
<hoinepage href ="index . html " /> 



wants b> rt\a^\^ a ^eviouslY-aownioadcu af?' 



<description>Head First WebStart demo</description> 
<icon href «"kathys . gif '7> 



<offIin.-.llo.«i/> T-te tt,. CTV^Tift* 



< / inf orma tion> 



<resources> 

<j2se version=''1.3+'7> 
<jar href ="My;^p. jar" /> 

</resources> 




TW.S sa^s ttat Vo^v f ^eeds vcKion I 
Java, or ^rcaW- 



<application-desc inain-classs"HelloWebStart"/> 
</jnlp> 



This is tike tKc w^aih-fcsi Main-Class cntvy... ii says 
whtdH diass ih ihc has the w^ainO metKod. 
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deploying with JWS 



Steps for making and deploying 
a Java Web Start app 



/Aake on executable JAk 
for your opplicotion. 



^ Wrfte Q .Jnip file. 



MyApp,|ar 



MyApp.JnIp 



Place your JAR and .JnIp 
files or\ your Web server. 




Add a new mime type to your Web server. 

appl i ca t ion / K - j ava - j Tap -fil« 

This causes the server to send the .jnIp file with the 
correct header, so that when the browser receives 
the jnIp file it knows what it is and knows to stort 
the JWS helper app. 



mliiHi typ« 



MyJWSApp.html 



@ Create a Web page wrth a link 
to your .jnIp file 
<HTML> 
<BODY> 

<a href="Myi^p2 , jnlp''>Launch My Application</a> 
</BODY> 
</HTML> 
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Look at the sequence of events below, and 
place them in the order in which they 
occur fn a JWS application. 



package, jars and deployment 



-f^^^f ^^ersendsaJAR, 

tt,e"wW^^?s^ y te to tf)e JWS helper a f^n 

\\A*c Vk^lner ADD ^ f^^ ^^^T 



the JWS helper app^ 



(he Webserver sends 
file to (he browser 



^eJARftle 



the JWS helper app invcrfces 
the JAR'S mainO method 



ser requests a jnlp file 
from the Web server 



How Is Java Web Start different ffx)m an applet? 

A- 

Applets can't live outside of a Web browser. An applet is 
downloaded from the Web as part of a Web page rather than 
simply from a Web page. In other words, to the browser, the applet 
Is just like a JPEG or any other resource. The browser uses either a 
Java plug-In or the browser's own built-in Java (far less common 
today) to run the applet. Applets don't have the same level of 
functionality for things such as automatic updating, and they must 
always be launched from the browser. With JWS applications, once 
they're downloaded from the Web, the user doesn't even have to 
be using a browser to relaunch the application locally. Instead, 
the user car\ start up the JWS helper app, and use It to launch the 
already-downloaded application again. 



What are the security restrictfons of JWS7 



A: 



JWS apps have several limitations including being 
restricted from reading and writing to the user's hard drive. But., 
JWS has its own API with a special open and save dialog box so 
that, with the user's permission, your app can save and read its 
own files In a special, restricted area of the user's drive. 



BUUET POINTS 




Java Web Start technology lets you deploy a 
stand-alone client application from Ihe Web. 

Java Web Start includes a 'helper app' that must 
be installed on the dienl (along with Java). 

A Java Web Start (JWS) app has two pieces: 
an executable JAR and a .jnlp file. 

A jnip file is a simple XML document that 
describes your JWS application. It includes 
tags for specifying the name and location of the 
JAR, and the name of the dass with the main() 
method. 

When a browser gets a .jnip file from the sen/er 
(because the user dicked on a link to the Jnip 
file), the browser starts up the JWS helper app. 

Tlie JWS helper app reads the .jntp file and 
requests the executable JAR from the Web 
sen/er. 

When the JWS gets the JAR, it invokes the 
mainO method (specified in the jnip file). 
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exercise: True or False 




We explored packaging, deployment, and JWS 
in this chapter. Your job is to decide whether 
each of the following statements is true or false. 



L The Java compiler has a flag, -d, that lets you decide where your .class files should go. 

2. AJAR is a standard directory where your .class fiJes should reside. 

3. When creating a Java Archive you must create a file caDed jarmf. 

4. The supporting file in a Java Archive declares which class has the main() method, 

5. JAR files must be unzipped before the JVM can use the classes inside. 

6. At the command line, Java Archives are invoked using the -arch flag. 

7. Package structures are meaningfully represented using hierarchies, 

8. Using your company's domain name is not recommended when naming packages, 

9. Diflferent classes within a source file can belong to different packages. 

10. When compiling classes in a package, the -p flag is highly recommended. 

11. When compiling classes in a package, the full name must mirror the directory tree, 

12. Judicious use of the -d flag can help to assure that there are no typos in your class tree. 

13. Extracting a JAR with packages will create a directory called meta-inf. 

14. ExtracdngaJARwith packages will create a file called manifest.mf. 

15. The JWS helper app always runs in conjunction with a browser 

16. JWS applications require a .nip (Network Launch Protocol) file to work properly. 

17. AJWS's main method is specified in its JAR file. 
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packagejars and deployment 




Across 

6. Wont travel 

9. Dont split me 

10. Release^ble 
n, Got the key 
12. 1/0 gang 
15. Flatten 

17. Encapsulated returner 

18. Ship this one 

21. Make ft so 

22. I/O sieve 
25. Disk leaf 



26. Mine is unique 

27. GUI's target 

29. Java team 

30. Factory 

32. Forawhile 

33. Atomic* 8 
35. Good as new 
37. Pairs event 
41.Wheredolstart 
42 AirttlefirewalJ 



Down 

1. Pushy widgets 

2. of my desire 

3. 'Abandoned' moniker 

4. A chunk 

5. Math not trig 

6. Be brave 

7. Arrange vwell 

8. Swing slang 
IK I/O canals 

13. Organized release 

14. Not for an instance 



1 6. Who's allowed 

19. Efficiency expert 

20. Early exit 

21. Common wrapper 

23. Yes or no 

24. Java jackets 
26, Not behavior 
28. Socket's suite 



Anything in the book 
is fair game for this 
one! 



30. 1/0 cleanup 

31. Milli-nap 
34. Trig method 
36, Encaps method 

38. JNLPfonnat 

39. VB's final 

40. Java branch 
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exercise solutions 




True 
False 
False 
True 
False 
False 
True 
False 
Folse 
False 
True 
True 
True 
True 
False 
False 
False 



1. 



2. 




b«w$er requests a. /nip file 
from the Web seiver 



tt\e Web server sends a .jnip 
file to the browser 



6. 



7. 



the Web browser starts up 
tha JWS hel per app 

1^eJARfite_ 

Web server sends a JAR 
fflelo the JWS helper af>n 



the JWS helper app invokes 
the JAR'S maInO method 



L The Java compiler has a flag, -d, that lets you decide where your .class files should go. 

2. AJAR is a standard directory where your .class fiJes should reside. 

3. When creating a Java Archive you must create a file called jar.mf. 

4. The supporting file In ajava Archive declares which class has the mainO method. 

5. JAR files mtist be unzipped before the JVM can use the classes inside. 

6. At the command Une, Java Archives are invoked using the -arch flag, 

7. Package structures are meaningfully represented using hierarchies. 

8. Using your company's domain name is not recommended when naming packages. 

9. Different classes within a source file can belong to different packages. 

10. When compiling classes in a package, the -p flag is highly recommended. 

1 1 . When compiling classes in a package, the full name must mirror the directory tree. 

12. Judicious use of the -d flag can help to assure that there are no r^os in your tree. 

13. Extracung a JAR with packages will create a directory called meta-inf. 

14. Extracting a JAR with packages will create a file called manifesLmf. 

15. The JWS helper app always runs in conjunction ^vith a browser. 

16. JWS applications require a .nip (Network Launch Protocol) file to work properly. 

17. AJWS's main method is specified in its JAR file. 
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1 8 remote deployment with RMI 

Distributed 
Computing 




Being remote doesn't have to be a bad thing, sure, things are easier when 

all the parts of your application are in one place< in one heap, with one JVM to rule them all. But 
that's not always possible. Or desirable. What if your application handles powerful computations, 
but the end-users are on a wimpy little Java-eoabled device? What if your app needs data 
from a database, but for security reasons, only code on your server can access the database? 
Imagine a big e-commerce back-end, that has to run within a transaction-management system? 
Sometimes, part of your app must run on a server, while another part (usuaify a client) must 
run on a different mach\nB. In this chapter, we'll learn to use Java's amazingly simple Remote 
Method Invocation (RMI) technology. We'll also take a quick peek at Servlets, Enterprise Java 
Beans (EJB) ,and Jini,and look at the ways in which EJB and Jini depend on RMI.We'il end the 
book by writing one of the coolest things you can make in Jawa^d^ universal service browser. 
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how many heaps? 









Executabte 




Mm 

RMapp 


Jar 


Web Start 



100% Local Combinotion 



Remote 



Method calls are always between 
two objects OH the same heap. 

So far in this book, every method we've invoked hzs been on 
an object running in the same virtual machine as the callen 
In other words, the calling object and the callee (the object 
we're invoking the method on) live on the same heap. 

class Foo { 

void go() { 

Bar b = new Bar ( ) ; 
b.doStuff 0 ; 

) 

public st:atic void main (String [] args) { 
Foo f = new Foo ( ) ; 



} 



} 



In the code above, we know that the Foo instance 
referenced by/ and the Bar object referenced by b are 
both on the same heap, run by the same JVM. Remember, 
the JVM is responsible for stuffing bits into the reference 
variable that represent how to get to an object on the heap. 
The JVM always knows where each object is, and how to 
gel to it. But the JVM can know about references on only 
its (mn heapl You can't, for example, have a JVM running 
on one machine knowing about the heap space of a JVM 
nmning on a differmt machine. In fact, a JVM running on 
one machine can*t know anything about a different JVM 
running on the xam^ machine. It makes no difference if 
the JVMs are on the same or different physical machines; 
it matters only that the two JVMs are, well, two different 
invocations of the JVM. 




In most applications, when or\e object 
calls 0 method on another, both objects 
are on the same heap. In other words, 
both ore running within the same JVM. 
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remote deployment with RMI 



What if you want to invoke a method on 
an object ranning on another machine? 

We know how to get information from one machine to another — 
with Sockets and I/O. We open a Socket connection to another 
machine, and get an OutputStream and ^vrite some data to it. 

But what if we actually want to call a methodon something running 
in another machine... anotherJVM? Of course we could always build 
our own protocol, and when you send data to a ServerSocket the 
server could parse it, figure out what you meant, do the work, and 
send back the result on another stream. What a pain, tjiough. Think 
how much nicer it would be to just get a reference to the object on 
the other machine, and call a method. 



Imagine two computers* 



1 




m 

Little Big 
Big kas sometkmgf Little wants. 
Compute powe r. 

Little wants to send some data to Big, so tkat Big can Jo tke 
keavy computing. 

Little wants simply to call a metkocL. 

double doCalcUsingPatabase (CalcNnmhers numbers) 

and get tadc tke result. 

But kow can Little get a reierence to an okject on Big? 
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two objects, two heaps 



Object A. runHihg on Little, wants to call 
a method on Object i rummq on Pig. 



The question is, how do we get an object on one machine 
(which means a different heap/JVM) to call a method on 
another n^achine? 



Well, not directly anyway. You can't get a reference to 
something on another heap. If you say: 

Dog d = ??? 

Whatever ^is referencing must be in die same heap space as 
the code running the statement 

But imagine you want to design something that will use 
Sockets and I/O to communicate your intention {a method 
invocation on an object running on another machine), yet 
sdU feelzs though you were making a local method caJl. 

In other words, you want to cause a method invocation on a 
remote object (i.e., an object in a heap somewhere else) , but 
with code that lets you pretend that you're invoking a method 
on a local object. The ease of a plain old everyday method 
call, but the power of remote method invocation. That's our 



That's what RMT (Remote Method Invocation) gives you! 

But let's step back and imagine how you would design RMI if 
you were doing it yourself. Understanding what you'd have to 
build yourself will help you learn how RMI works. 
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l^ut you cant do that. 



goal. 



remote deployment with RMI 



A design for remote method calls 

Create four things: server, client, 
server lieiper, client heiper 



Create client and server apps. The server app is the 
remote service that has an object with the method 
that the client wants to Invoke. 




Create client and server "helpers". They'll handle all 
the low-level networking and 1/0 details so your client 
and sery'ice can pretend like they're in the same heap. 
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client and server helpers 



The role of the 'helpers' 



The 'helpers' are the objects that actually do the communicating. 
They make it possible for the client to ^^as though its calling a 
method on a local object. In fact, it is. The client caJls a method on 
the client helper, as if the cUent helper wen the actual service. The client 
helper is a proxy for ike Real Thing. 

In other words, the client object ihinhs it s calling a method on 
the remote service, because the client helper \^ pretending to be 
the service object. Pretending to be the thing unth the method the client 
wards to call! 

But the client helper isn't really the remote service. Although the 
client helper acts^Wit it (because it has the same method that the 
service is advertising), the client helper doesn't have any of the 
actual method logic the client is expecting. Instead, the client 
helper contacts the server, transfers information about the med^od 
caU (e.g., name of the method, argiunents, etc.)) ^md waits for a 
return from the server 

On the server side, the service helper receives the request from 
the client helper (through a Socket connection), unpacks the 
information about the call, and then invokes the realmtihod on 
the raa/ service object. So to the service object, the call is local. It's 
coming from the service helper, not a remote cUent. 

The service helper gets the retum value from die service^ packs it 
up, and ships it back (over a Socket's output scream) to the client 
helper. The client helper unpacks the information and returns the 
value to the client object 



Your client object gets to 
act like rfs making reitiate 
mefiiod calls- Butwkat 
tfs really doing is calling 
medio(Is on a he^-local 
^QVf object tkt Kandles 
all ^e low-level details of 
Soclcets and streams- 



y,,^k. ^^^^^^^ 



Client heap 



fee \yt ^'^^'"'rV 




Server heo|> 




^iytii +f o» the dlieh£ 

"'Is i\c method Oh {yt 
Ku\ Strvide. 



\ »tt"«'^ the 
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remote deployment with RMI 



How the method call happens 



Client object calls doBigThingO on the client helper object 



Client heap 




Server heap 




Client helper packages up Information about the call 
(arguments, method name, etc.) and ships it over the 
network to the service helper. 



Client heap -^^^^^^ ^ ^^^^^^u Sen^er^^ 




Service helper unpacks the information from the client helper, 
finds out which method to call (and on which object) and 
Invokes the rea l method on the re^l ser\/icz object. 

Q Clfeftt heap ^^^^^ ^ J ^ Seiwheop 




doBigThingO 



0 
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RMI helper objects 



Java I^MI gives you the client and 
service helper objects! 

In Java, RMJ builds the client and service helper 
objects for you, and it even knows how to make the 
client helper look like the Real Service. In other 
words» RMI knows how to give the client helper 
object the sanne methods you want to call on the 
remote service. 

Plus, RMI provides ail the rundme infrastructm-e to 
make it work, including a lookup service so that the 
client can find and gel the client helper (the proxy 
for the Real Service). 

With RMI, you don'i write an^ of the networking 
or I/O code yourself. The client gets to call remote 
methods (i.e. the ones the Real Service has) just 
like normal method calls on objects running In the 
client's own local JVM, 

AJmost 

There is one diiTerence between RMI calls and local 
(normal) method calls. Remember that even though 
to the client ic looks like the method call is local, 
the client helper sends the method call across the 
network. So there is networking and I/O. And what 
do we know about networking and I/O methods? 

They're risky! 



They throw exceptions all over the place, 

So, the client does have to acknowledge the risk. The 
client has to acknowledge that when it calls a remote 
method, even though to the client it's just a local call 
to the proxy/helper object, the call uUirmUely ijivolves 
Sockets and streams. The client's original call is load, 
but the proxy turns it into a rernote call. A remote call 
just means a method that s invoked on an object on 
another JVM. Hmv the information about that call 
gets transferred from one JVM to another depends 
on the protocol used by the helper objects. 

With RMI, you have a choice of protocols: JRMP or 
IIOR JRMP is RMI's 'native' protocol, tlie one made 
just forjava-tojava remote calls. HOP, on the other 
hand, is the protocol for COREA (Common Object 
Request Broker Architecture), and lets you make 
remote calls on things which aren't necessarily Java 
objects. CORBA is usually tnucAmore painful than 
RMI, because if you don't have Java on both ends, 
there's an awful lot of translation and conversion that 
has lo happen. 

But thankfully, all we care about is Java-tojava, so 
we're sucking with plain old, remarkably easy RMI, 



In RMI, the client helper is a 'stub' 
and the server helper is a 'skeleton'. 



^2 Client heap 
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remote deployment with RMI 



Making the Remote Service 

This is an overview of the five steps for making the remote 
service (that runs on the sender). Don't worry, each step is 
explained in detail over the next few pages. 



Server 




Step one: 

Make a Remote Interface 

The remote interface defines the methods 
that a client can call remotely. It's what 
the client will iise as the polymorphic class 
type for your service. BolJi the Stub and 
actual service \vill implement tliisi 

Step two: 

Make Q Remote Implementation 

This is the class that does the Real Work. 
It has the real implementation of the 
remote methods defined in the remote 
interface. Ws the object that the client 



MyRemotd.java 



MyRemot^lmplJava 



,TVc Real S^V*"- Tt^ctU^ 

Uivvc -e^^ twatao 



Step three: 

Generate the stubs and skeletons using rmic 
These are the client and server 'helpers'. 
You don't have to create these classes or ever 
look at the source code that generates them. 
It's all handled automatically when you 
run the rmic tool that ships with your Java 
development kit 

Step four: 

Start the RMI registry (rmiregistry) 

The rmiregistry is like the white pages of a 
phone book. It*s where the user goes to get 
the proKy (the client stub/helper object). 



I File Edit Wtndow H&1pjaj_ | 



;nnic MyReTnotelmpl 



^ i.. 
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MyRemotelmpLStub.class 



0 M D 
OOt 10 

001 Oi 



[ We Edii WTrtdow Hsip Drink 



%rmi registry 



MyRemotefmpLSkeLclass 



Step five: 

Start the remote service 

You have to get the service object up and nmning. 
Your service implementation class instantiates an 
instance of the service and registers it\vith the RMI 
registry. Registering it makes the semce available for 
clients. 



I nie Edii Window Help ^eMerry 



%java MyRemotelmpl 
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a remote interface 



Step one: Make a Remote Interface 



^ Extend java.rmLRcmote 

Remote is a *marker' interface, which means it has no methods. It has 
special meaning for RMI, though, so you must follow this rule. Notice 
that we say 'extends' here. One interface is allowed to extend 3,noth^Y 
interface. 



MyRemote.java 



public interface MyRexnote 



{ 



Declare that all methods throw a RemoteException 

The remote interface is the one the client uses as the polymorphic type 
for the service. In other words, the client invokes methods on something 
that implements the remote interface. That something is the stub, of 
course, and since the stub is doing networking and I/O, all kinds of Bad 
Things can happen. The client has to acknowledge the risks by handling 
or declaring the remote exceptions. If the methods in an interface 
declare exceptions, any code calling methods on a reference of that type 
(the interface type) must handle or declare the exceptions. 



import java.rmi. 



i^.e Remote ■mi.r^a.e .s mjavaW. 



public interface M/Remote extends Remote { 
public String sayHelloO throws 

} 



B€ sure arguments and return values are primitives or Serializable 

Arguments and return values of a remote method must be either primitive 
or Serializable. Think about it. Any eirgument to a remote method has to 
be packaged up and shipped across the network, and that's done through 
Serialization. Same thing with return values. If you use primitives, Strings, 
and the majority of types in the API (including arrays and collections), 
you'll be fine. If you are passing around your own types, just be sure that 
you make your classes implement Serializable. 



public 




sayHello ( ) throws RemoteException ; 

Thh ^eiurn .aU is aoK^a be sKiffed 

rtt^''^^^ «.ust be Serializable 
I Hats hov. atrgs and ^tiurn values ati 



4U m^:£'^^^«^• 



m 

an' 




Every remote method tall is 
Considered Visky\ Deelarina 
KemotcExdepiioh oh every 
^ethod Westhe dicnt 

pay attention and 
aeknowlcdsc that tKin^s 

'^'SKt not work. 



remote deployment with RMI 

Step two: Make a Remote Implementation 



Implement the Remote interface 

Your service has to impleroent the remote interface — the one 
with the methods your cUent is going to call. 

public class MyRemoteIit5>l extends UnicastRemoteObject 

public String sayHello() ^ 

return ^'Server says , ^Hey' ; Coff.f\lcr wi(f makt suv-e tKat 

+J-om the m-U^hc€ you mfk^cni 
J this t^ze, ihtrc's only 



MyRemotelmpl.java 



Extend UnicastRemoteObject 

In order to work as a remote service object, your object needs some 
functionality related to 'being remote'. The simplest way is to extend 
UnicastRemoteObject (from the java.rmi.server package) and let that 
class (your superclass) do the work for you. 

public class MyRemotelicipl 



in^lements MyRemote { 



Write a no-arg constructor that declores a RemoteException 

Your new superclass, UnicastRemoteObject, has one httle problem — its 
constructor throws a RemoteException. The only way to deal with this is 
to declare a constructor for your remote implementation, just so that you 
have a place to declare the RemoteException. Remember, when a class is 
instantiated, its superclass constructor is always called. If your superclsiss 
constructor throws an exception, you have no choice but to declare that 
your constructor also throws an exception. 

public MyRemotelztipl ( ) 




Register the service with the RMI registry 

Now that you've got a remote service, you have to make it available to 
remote clients. You do this by instantiating it and putting it into the RMI 
registry (which must be running or this line of code fails) . When you 
register the implementation object, the P^I system actually puts the sttcb in 
the registry, since that's what the client really needs. Register your service 
using the static rebind() method of the java.rmi,Naniing class, 
try { 

MyRemote service = new MyRemotelicipl () ; 



} cat^ 
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step three: generate stubs and skeletons 



Run rmic on the remote implementation doss 
(not the remote interface) 

The rmic tool, that comes with the Java sofnvare 
development kit, takes a service implementation and 
creates two new classes, the stub and the skeleton. 
It uses a naming convention that is the name of 
your remote implementation, with either _Stub or 
.Skeleton added to the end. There are other opdons 
witii rmic, including not generating skeletons, 
seeing what the source code for these classes looked 
like, and even using IIOP as the protocol. The way 
we're doing it here is the way you'll usuaUy do it 
The classes will land in the current directory (i.e. 
whatever you did a cd to). Remember, rmkmust 
be able to see your implementation class, so you'll 
probably run rmic from the directory where your 
remote implementation is. (We're deliberately not 
using packages here, to make it simpler. In the Real 
World; you'll need to account for package directory 
structures and fully-qualified names). 



^ end. U das. r^r^t. 

1 Fila Ed>l Window Help Whuffle | 






%rTiiic MyRemotelmpl 



Id U4 \ 
Olid 

<iO\ 10 
M» 01 



MyRdmotelmpL^b.cIass 

110 1 



h^RemotelmpLSkelxlass 



Step four: run rmiregistry 



Bring up a terminal and start the rmiregistry. 

Be sure you start it from a directory that has access 
to your classes. The simplest way is to start it from 
your ^classes' directory. 



I F\ie Edit Window Help H^^hT 



^rmiregistry | 



Step five: start the service 



ij^ Bring up another terminal and start your service 

This might be from a main() method in your remote 
implementation class, or from a separate launcher class. 
In diis simple example, we put the starter code in die 
implementation class, in a main method that instantiates 
the object and registers it widi RMI registry. 



I flte EdH Windcw Help Huh? 



%java MyRemotelmpl 
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Complete code for the server side 

Server 

The Remote interface: 

inmort java . nni . * ; mttr+dt£ <»'rc j 

public interface MyRemote extends Remote { javaW^Rtr»*o^ 

^ public String flayHella() throws RemoteException^^ d^da^c a Rerno^e^A^pton 



The Remote service (the implementation): 

insert java . x,^ > ; ^ ^.a--'^'^^^ ^ ^^"^^ fa^^-^^ ^3^^^ 

in^jort java . rmi . server . * ; ^ ^i\t^\^ ^^^^ 

public class HyRemotelnipl extends UnicastRomoteObject in^laments MyRemote ( 

public string sayHello () ( ^"T H'' "t- -H^-'nt all iK< ^^^^T '"/'«-«--t 

return "Lrv^r says. >aey' "; '"^^'if l^^-^^> ^ ^u«*. ^''^ i^W,,,// y^**^ 

public MyHamotelnipl ( ) throws RamotaException { ) iuPCVtU" tow^Jrvfi'to*' ^■fo*' 

you r^usl v^-.b: a ^>rviWU> bctausc -eans 

public static void main (String [] args) ( ^oyvsWi^ ^''''^^ ^^^^f ^"^^ 

try { ^ 
MyRemote service = new MyRemote In^)! () ; ^^-x^ 
NasLing. rebind(^^Remote Heiic", service); 
} catch (Exception ex) { 
ex.printStackTrace () ; 



•^-e you legist;,. i£ un^rv . A , '^^ 
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getting the stub 



How does the client get the stub object? 

The client has to get the stub object, since that's the thing the 
client will call methods on. And that's where the RMl registry 
comes in. The client does a 'lookup', like going to the white pages 
of a phone book, and essentially says, "Here's a name, and Vd like 
the stub that goes with that name." 



MyRemote service » (MyRemote) 

\ T 

thc^i always the ^ ^- ""^^ f° 



lookups u a statit method <>f 

Naming . lookup (^nni : //127 .0.0. 1/Remote Hello" ) ; 



Jyp« the set-vite. |^ ^afii 
the dliet^t neve,r r^ctdi h> k^ow 
the atiual tlau ^ y^,^^ 



method retuiTM tyye Objett 



7^ 

y<>uv Vios^ i^ai^C o\r |P 




P Client does a lookup on the RMI registry 

Naming . lookup (^rmi : //127 . 0.0. l/Ranota Hello") 



RMI registry returns the stub object 

(as the return value of the lookup method) and RMI 
deserializes the stub automatically You MUST have 
the suib class (thai rmic generated for you) on the 
client or the stub won't be deserialized. 



Client invokes a method on the stub, as 
though the stub IS the reol service 
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remote deployment with RMI 

How does the client get the stub class? 

Now we get to the interesting question. Somehow, someway, the 
cHent must have the stub class (that you generated earlier using 
rmic) at the time the client does the lookup, or else the stub won't 
be deserialized on the client and the whole thing blows up. In a 
simple system, you can simply hand-deliver the stub class to the 
client 

There's a much cooler way, though, although it's beyond the 
scope of this book. But just in case you're interested, the cooler 
way is called "dynamic class downloading". With dynamic class 
downloading, a stub object (or really any Serialized object) is 
^stamped' with a URL that tells the RMI system on the client 
where to find the class file for that object. Then, in the process of 
deserializing an object, if RMI can't find the class locally, it uses 
that URL to do an HTTP Get to retrieve the class file. So you'd 
need a simple Web server to serve up class files, and you'd also 
need to change some security parameters on the client. There are 
a few other tricky issues with dynamic class downloading, but that's 
the overview. 



Complete client code 

import java.md.*; ^ J^^^^^ 

pxablic class MyRemoteCIient { 

public static void main ( String [] args) { 
new ^RemoteClient 0 .go() ; 

public void go 0 { '^l^i^ " 

try { >t 

MyRamote service = (MyRemote) Naming. lookup ("rmi : //127 . 0 . 0 . 1/Remote Hello"); 

7 \ 

string s = service. sayHelloO ; y^^, . li^ to jj ^ A 

System. out. println(s) ; \ hmd/'rtvw^a ^ 

} catch (Exception ex) { 'ool^s 



} 

} 
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RM1 class files 



?e sure each machine has the class 
files it heeds. 

The top three things programmers do wrong with RMI are: 

1) Forget to start rm [registry before starting remote service 
{when you register the service using Naming,rebind(), the 
rmiregistry must be runningl) 

2) Forget to make arguments and return types serializable 
(you won^i kjiow until runtime; this is not something the 
compiler will detect) 

5) Forget to give the stub class to the client. 



Vori -forget, tV^C dlitfht 

usci i\\c in-tcv-fade to tsW 
n^etVsods Oh t^c rtub- T\\t 
thtni Jl/AI n^tfds stub 
dasij but tVitf t\\Chi t\c^/cv■ 
^c-fm to tKc stub d^is 
ih toiie. TKc dlict\t always 
uses t^^ ycwoti mtc^^atCj 
as tKougb tKc vcwot^ 

^adc VVERE t^c 
adtual rewrote objtfit- 




Cllentclass MyRemotelmpLStubxIass 




MyRemotalmpLdass 



MyRdmotelmpLStubxlass 



10 iia" 1 

« 11 0 



MyRemotelmpLSkeLclass 



IQlLOl C 
4 11 



MyRamote^dafls 



^r^ti- y^ttd^ botK t>^C Stub ay^d Sk«lrto»^ 

itais«S| as v/€tl as t>^c sc^vit^ av^d t^c 
rtmottf int«v^d£^. [t fiZtdi {ht ihA> diass 
b^djus^ rcwitfmbor, tb« itub is substit»*t«d 
ie»r i^C rcB\ 50rV)dt> wV»^ i^t veal SOrvidC 
k bound to tWc RMI ^e^istry. 
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Look at the sequence of events below, and 2. 
place them in the order in which they 
occur in a Java RMI application. 




5. 
6. 



BUUET POINTS 




An object on one heap cannot gel a nomnal Java 
reference to an object on a different heap (which means 
running on a different JVM) 

Java Remote Method Invocation (RMI) makes it seem like 
you're calling a method on a remote object (I.e. an object 
in a different JVM), but you aren't. 

When a client calls a method on a remote object, the 
client is really calling a method on a proxy of the remote 
object The proxy is called a 'stub'. 

A stub is a client helper object that takes care of the low- 
level networking details (sockets, streams, serialization, 
etc.) by packaging and sending method calls to the 
server. 

To build a remote service (in other words, an object that 
a remote client can ultimately call methods on), you must 
start wUh a remote interface. 

A remote interfece must extend the java.miLRemote 
Interface, and all methods must declare 
Remote Exception. 

Your remote sen/ice implements your remote interface. 



Your remote sen/ice should extend UnicastRemoteObject. 
(Technically there are other ways to create a remote ob- 
ject, but extending UnicastRemoteObject is the simplest). 

Your remote service class must have a constructor, 
and the constructor must declare a RemoteException 
(because the superclass constructor declares one). 

Your remote sendee must be instantiated, and the object 
registered with the RMI regis&y. 

To register a remote service, use the static 
Naming.rebindCService Name', sen/icelnstance); 

The RMI registry must be running on the same machine 
as the remote sen/ice, before you try to register a remote 
object wrth the RMI registry. 

The client looks up your remote seAnce using the static 
Naming.lookup("rmi://MyHostName/Sen/iceName''); 

Almost everything related to RMI can throw a 
RemoteException (checked by the compiler). This 
Includes registering or looking up a sen/Ice In the reigstry. 
and all remote method calls from the client to the stub, 
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uses for RMI 

YeaK but who really uses RMI? 
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100% Local Combination 



100% ftemote 



What about Servlets? 

Servleis are Java programs that run on (and ^sith) an HTTP web server When a client uses a 
web browser to interact with a web page, a request is sent back to the web server. If the request 
needs the help of a Java servlet, the web server runs (or calls^ if the servlet is already running) 
the servlet code. Servlet code is simply code that runs on the server, to do work as a result of 
whatever the client requests {for example, save information to a text file or database on the 
server). If you're familiar with CGI scripts written in Perl, you know exactly what we're talking 
about. Web developers use CGI scripts or servleis to do everything from sending user-submitted 
info to a database, to running a web-site*s discussion board. 

And even servkls can vse RMI! 

By far, the most common use of J2EE technolog>' is to mix servlets and EJBs together, where 
servlets are tl^e client of the EJB, And in tliat case, the servlet is using RAH to talk to iheEJBs^ 
(Although the way you use RMI with EJB is a /i///^ different from the process we just looked at.) 

Client fids out a reg/strotron form and clicks 'submif . 
The HTTP server (i.e. web server) gets the request, sees that 
it's for a servlet, and sends the request to the servlet. 



Web Browser 

(client) "client rc^juesr^ RegisterServlef 



Web Server 





Servlet (Java code) runs, odds data to the database, 
composes a web page (with custom Info) and sends it back to 
the client where it displays in the browser. 



Web Browser 

(client) "client re^/uestsRe^istcrServlef 



Web Server 





's a confirmatfon pcge" 



cortflnD.html 
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very simple servlet 

Step for making and running a servlet 



^ Find out where your scrvlcts need to be pieced. 

For these examples, we'll sissiune thai you already have a web server 
up and running, and that it's already configured to support servlets. 
The most important thing is to find out exactly where youx servlet 
class files have to be placed in order for your server to *see' them. If 
you have a web site hosted by an ISP, the hosting service can tell you 
where to put your servlets, just as they'll tell you where to place your 
CGI scripts. 



Web Server 




Set the servietsjop and odd it to your closspath 

Servlets aren^t part of the standard Java libraries; you need 
the servlets classes packaged into the servletsjar file. You can 
download the servlets classes from java.sim, com, or you can get 
them from your Java-enabled web server {like Apache Tomcat, at 
the apache.org site). Without these classes, you won't be able to 
compile your servlets. 



servlats^Jar 



Wrrte a servlet doss by extending HttpServlet 

A servlet is just a Java class that extends HttpSer\'let (from the 
javax.servlechttp package). There are other types of servlets you 
can make, but most of the time we care onjy about HttpServlet 



MyServtdtA.d3 



public class MyS«rvlatA extands HttpServlet { ... } 



^ Write on HTML poge that invokes your servlet 

When the tiser clicks a link that references your servlet, the web 
server will find the servlet and invoke tiie appropriate method 
depending on the HTTP command (GET, POST etc.) 

<a href="fiervlets/MyServletA">This ia the moat 



MyPage.html 



amazing servlet. </a> 



(§) Make your servlet and HTML page available to your server 

This is completely dependent on your web server (and more specifi- 
cally, on which version of Java Servlets iliat you're using). Yoiu ISP 
may simply tell you to drop it into a ''Servlets" directory on your 
web site. But if you're using, say, the latest version of Tomcat, you^ll 
have a lot more work to do to get the servlet (and web page) into 
the right location. (We just happen to have a book on this too .) 



Web Server 
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servlets and JSP 

I BULLET POIHTS^^W 

■ Servlets are Java classes that run entirely on 
(and/or within) an HrrP (web) server. 

■ Servlets are useful for running code on the 
server as a result of client interaction with a 
web page. For example, if a client submits 
Information in a web page form, the servlet can 
process the infonnation, add it to a database, 
and send back a customized, confimnation 
response page. 

■ To compile a servlet, you need the servlet 
packages which are in the servlets.jar file. The 
servlet classes are not part of the Java standard 
libraries, so you need to download the servlets. 
jar from java.sun.com or get them from a servlet- 
capable web server. (Note: the Servlet library 

is included with the Java 2 Enterprise Edition 
(J2EE)) 

■ To run a servlet, you must have a web server 
capable of running servlets, such as the Tomcat 
server from apache.org. 

■ Your servlet must be placed in a location that's 
specific to your particular web server, so you'll 
need to find that out before you try to run your 
servlets. If you have a web site hosted by an ISP 
that supports servlets, the ISP will tell you which 
directory to place your servlets in. 

■ Atypical servlet extends HttpServlet and 
overrides one or more servlet methods, such as 
doGetQ or doPostQ. 

■ The web server starts the servlet and calls the 
appropriate method (doGet(), etc.) based on the 
client's request. 

■ The servlet can send back a response by getting 
a PrintWriter output stream from the response 
parameter of the doGet() method. 

■ The servlet 'writes' out an HTML page, complete 
with tags). 



What's a JSP, and how does it relate to servlets? 

A- 

JSP stands for Java Server Pages. In the end, the web server 
turns a JSP into a servlet, but the difference between a servlet and 
a JSP is what YOU (the developer) actually create. With a servlet, 
you write a Java class that contains HTML in the output statements 
(if youVe sending back an HTML page to the client). But with a 
JSP, it's the opposite— you write an HTML page that contains Java 
code! 

This gives you the ability to have dynamic web pages where you 
write the page as a normal HTML page, except you embed Java 
code (and other tags that "trigger" Java code at runtime) that 
gets processed at runtime. In other words, part of the page is 
customized at runtime when the Java code runs. 

The main benefit of JSP over regular servlets is that it's just a lot 
easier to write the HTML part of a servlet as a JSP page than to 
write HTML in the torturous print out statements in the servlet's 
response. Imagine a reasonably complex HTML page, and now 
imagine formatting it within printin statements. YikesI 

But for many applications, it isn't necessary to use JSPs because 
the servlet doesn't need to send a dynamic response, or the 
HTML is simple enough not to be such a big pain. And, there are 
still many web servers out there that support servlets but do not 
support JSPs, so you're stuck. 

Another benefit of JSPs is that you can separate the work by 
having the Java developers write the servlets and the web page 
developers write the JSPs. That's the promised benefit, anyway. 
In reality, there's still a Java learning curve (and a tag learning 
curve) for anyone writing a JSP, so to think that an HTML web page 
designer can bang out JSPs is not realistic. Well, not without tools. 
But that's the good news— authoring tools are starting to appear, 
that help web page designers create JSPs without writing the 
code from scratch. 

Is this all you're gonna say about servlets? After such a 
huge thing on RMI? 

A- 

Yes. RMI is part of the Java language, and all the classes for 
RMI are in the standard libraries. Servlets and JSPs are not part of 
the Java language; they're considered standard extensions. You 
can run RMI on any modern JVM, but Servlets and JSPs require a 
properly configured web server with a servlet "container'^ This is 
our way of saying,"it's beyond the scope of this book." But you can 
read much more in the lovely Head First Servlets & JSP. 
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Just for f uw, let's wake the Phrase-O-Matic 
work as a servlet 



Now that we told you that we won't 
say any more about servlets. we can't 
resist servleiizing (yeS; we c»nverbiiy 
it) the Phrase-O-Matic from chapter 1. 
A servlet is still justjava. And Java code 
can call Java code from other classes. 
So a servlet is free to call a method on 
the Phrase-O-Matic, AD you have to do 
is drop the Phra&e-O-Matic class into 
the same directory as your servlet, and 
youVe in business. (The Phrase-O- 
Matic code is on the next page) , 



I 




Try my 
new web-enablcd 
phrose-o-matic and you'll 
be a slick talker just like 
the boss or those guys in 
marketing. 



import java.io.*; 

import javax. servlet .* ; 
import javax. servlet. http.*; 

public class KathyServlet extends HttpServlet ( 

public void do Get (HttpServletRequest request , HttpServletRasponse response) 

throws ServletException, lOException { 

String title = ^^PhraseOMatic has generated the following phrase."; 



response. setContentType C'text/htzal") ; 
PrintWriter out = response, getWriter () ; 



out.println("<HTMIXHEADXTITLE>") ; 
out.println C^PhraaeOmatio'') ; 
out.println(^^</TITLEX/HEADXBODY>") ; 
out.println(^^<Hl>" + title + ^^</HlV') ; 
out.println(''<P>" + PhraaeOMatic .makePhrasa () ) ; 

out.println (^<PXa href=\''KathyServlet\">tnake another phrase</aX/p>'') ; 
out.println(^X/BODYx/HTML>") ; 



out. close () ; 
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Phrase-O-Matic code 

Phrasc-O-Matic code, servlct-f ricwdly 

This is a slightly different version from the code in chapter one. In the 
original, we ran the entire thing in a main() method, and we had to rerun 
the program each time to generate a new phrase at the command-line. In this 
version, the code simply returns a String (with the phrase) when you invoke 
the static makePhrase() method. That way you can call the method from any 
other code and get back a String with the randomly-composed phrase. 

Please note that these long String!'] array assignments are a victim of word- 
processing here — don't type in the hyphens! Just keep on typing and let your 
code editor do the wrapping. And whatever you do, don't hit the return key in 
the middle of a String (i.e. something between double quotes). 



public class PhraseOMatic { 

pTiblic static String makePhrase ( ) { 

// make three sets of words to choose from 

String [] wordListOne = {^^24/7","multi-Tier'\"30,000 foot" , "B-to-B" /'win-win" /'front- 
end" , "web-based'' , "pervasive" , "smart" , "six-sigma" , "critical -path" , "dynaitiic" } ; 

String[] wordListTwo = {"empowered", "sticky", "valued- added" , "oriented", "centric", 
"distributed", "clustered", "branded" , "outside-the-box" , "positioned", "networked", "fo- 
cused", "leveraged", "aligned", "targeted", "shared", "cooperative", "accelerated"}; 

String [] wordListThree = {"process", "tipping point", "solution", "architecture", 
"core cort5>etency" , "strategy" , "mindshare" , "portal" , "space" , "vision" , "paradigm" , "mis- 
sion" } ; 

// find out how meuiy words are in each list 
int oneI*ength = wordListOne. length; 
int twoLength = wordListTwo . length; 
int threeLength = wordListThree . length; 

// generate three random numbers, to pull random words from each list 
int randl = (int) (Math . random ( ) * oneLength) ; 
int rand2 = (int) (Math . random { ) * twoLength); 
int rand3 = (int) (Math . random ( ) * threeLength) ; 

// now build a phrase 

String phrase = wordListOne [randl] + " " + wordListTwo [rand2] + " " + 
wordListThree [rand3] ; 

// now return it 

return ("What we need is a " + phrase) ; 

} 

} 



630 chapter 18 



remote deployment with RMI 



^i1terpr^se JavaPeans: KMI on steroids 

RMI is great for writing and nmning remote services. But 
you wouldn't run something lilce an Amazon or eBay on RMI 
alone. For a large, deadly serious, enterprise application, you 
need something more. You need something that can handle 
transactions, heavy concurrency Issues (like a gaziUion 
people are hitting yotu' server at once to buy those organic 
dog kibbles), security (not just anyone should hit your 
payroll database), and data management. For that, you need 
an enterprise application server. 

In Java, that means a Java 2 Enterprise Edition (J2EE) server 
AJ2EE server includes both a web server and an Enterprise 
JavaBeans(EJB) server, so that you can deploy an application 
that includes both servlets and EJBs. Like servlets, EJE is 
way beyond the scope of this book, and there's no way to 
show "just a httle" EJB example with code, but we will take 
a quick look at how it works. (For a much more detailed 
treatment of EJB, we can reconrunend the lively Head First 
EJB certification study guide.) 



An EjB server adds a bimcK 
of services iliat you don't get 
widistrai^IM. Tilings 
like transaefions, secmify. 
concorrency, database 
inamgemertt, aiul networltii^g- 

AnEjB server steps 
vAddle of an RMI call and 
layers in all of tlie services. 




a/l tKe itfri/ide, provided bv IL^ f )R 



T^is does, that 



RMI SKELETON 



o 





CrO 



i 



This is only a small part of the EJ6 picture' 
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a little Jini 



For our final trick... a little Jihl 

We love Jini. We think Jini is pretty nnuch the best thing in Java. If EJB is RMI 
on steroids (with a bunch of managers) , Jini is RMI \^th wings. Pure Java bliss 
Like the EJB material, we can*tget into any of the Jini details here, but if you 
know RMI, youVe three-quarters of the way there. In terms of technology, 
anyway. In terms of mindset, it's time to make a big leap. No, it's time to Jly. 

Jini uses RMI (although other protocols can be involved), but gives you a few 
key features including: 

Adaptive discmery 

Se^-healing networks 

With RMI, remember, the client has to know the 
name and location of the remote service. The 
client code for the lookup includes the IP address or 
hostname of the remote service (because that*s where 
the RMI registry is running) and the logical name the 
seiAice was registered under. 

But with Jinij the client has to know onJy one thing: the 
interface implemented by ike sennce^ Thai's ii. 

So how do you find things? The trick revolves around Jini lookup 
services. Jini lookup services are far more powerful and flexible Uian 
tl^e RMI registry, for one tiling, Jini lookup services announce themselves to the 
network, aulorruilicaUy. When a lookup service comes online, it sends a message (using IP 
multicast) out to the network saying, Tm here, if anyone s interested." 

But that's not ail. Lets say you (a client) come online after the lookup service has already 
announced itself> you can send a message to die entire network saying, "Are there any 
lookup services out there?*' 

Except that youVe not really interested in the lookup service itselj^yon'rt interested in 
the services Uiat are r^^^rfwith the lookup service. Things like RMI remote services, 
other seriaJizable Java objects, and even devices such as printers, cameras, and coffee- 
makers. 

And here's wliere it gets even more fun: when a service comes online, it will dynamically 
discover (and r^^^ itself with) any Jini lookup services on the network. When the 
service registers vAih the lookup service, the service sends a serialized object to be placed 
in the lookup service. That serialized object can be a stub to an RMI remote service, a 
driver for a networked device, or even the whole service itself that (once you get it from 
the lookup service) runs locally on your machine. And instead of registering by name, the 
service registers by the interfaced implements. 

Once you (the client) have a reference to a lookup service, you can say to that lookup 
service, ''Hey, do you have anything that implements ScientificCalculator?" At that point, 
the lookup service will check its list of registered interfaces, and assuming it finds a 
match, says back to you, ^Yes I //ohave something that implements that interface. Here s 
the serialized object the ScientificCalculator service registered with me."" 
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Adaptive discovery in action 

^ Jim" lookup service is launched somewhere on the network, and 
announces itself using IP multicast. 




An afready-running Jini service on 
another machine asks to be registered 
with this ncwly-onnounced lookup 
sers^ice. It registers by capability, 
rather than by name. In other words, 
it registers as the service interface it 
implements. It sends a serialized object 
to be placed in the lookup service. 



Jini Lookup Service 



Register 
i OS something 
that implements 
ScientificCafculotor. Here's a 
seriQliied object that represents 
my service. Send it to 
anybody who asks... 




another machine on the network 



/ 




machine on the network 
somewhere,.. 



another machine on the network 
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adaptive discovery in Jinr 

Adaptive discovery m action, cowtiwued-.. 

^ A client on the network wonts 
something that implements the 
ScientificCalculotor interface. It has 
no idea where (or if) that thing exists, 
so it asks the lookup service. 



Jini Service 



another machine 
or the network 




machine on the network 
somewhere... 



onother machine on the network 



The lookup service responds, since it does have something 
registered as a ScientiftcCalculator interface. 




634 chciptefit 



remote deployment with RMI 



Self healing network m action 



^ A Jini Service has asked to register with the lookup service. The lookup 
service responds with q ^leose". The newly-registered service must keep 
renewing the lease, or the lookup service ossumes the service has gone 
offline. The lookup service wants always to present an accurate picture 
to the rest of the network about which services are available. 




machine on the network 
somewhere... 



another machine 
on the network 



another nwichine on the network 



The service goes offline (somebody shuts it down), so it fails to 
renew its lease with the lookup service. The lookup service drops it. 




another machine on the network 



machine on the network 
somewhere... 



another machine on the network 
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universal service project 

Final Project; the Universal Service browser 

WeYe going to make something that isn't Jini-enabled, but quite easily could be. 
It will give you the flavor and feeling of Jini, but using straight RMI. In fact the 
main difference between our application and ajini application is how the service is 
discovered. Instead of ihejini lookup service, which automatically announces itself and 
lives ariywhere on the network, we're using the RMI registry which must be on the same 
machine as the remote service, and which does not announce itself automatically. 

And instead of our service registering itself automatically with the lookup service, we 
have to register it in the RMI registry (using Naming, rebindO). 

But once the client has found the service in the RMI registry, the rest of the application 
is almost identical to the way we'd do it in Jini. (The main thing missing is the UasethTH 
would let us have a self-healing network if any of the services go down.) 

The universal service browser is like a specialized web browser, except instead of HTML 
pages, the service browser downloads and displays interactive Java GUIs that we're 
calling universal servkes. 



1 



/ Day of the W€ck Service 
DIcft Rolling Service 



Vs^u^i' M.J It: ServKe 




Choose a i€r^\U irotr^ -Uc 
, list TVvc RyVJl ttfncic ur^\U 

ft^rtKod ichds ba^k tKis 
list sevwiiici. 

tKe die^t AtVs (&r b\t 
^th^\ sev-via (t>i£-£Rollift5> 

be sent batk -fv-om tKe R/Vll 



a SI 
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How it works: 



Client starts up and 
does a lookup on the 
RMI registry for 
the service called 
"ServiceServer", and 
gets back the stub. 



Service Browser 
(client) 



Server 





RMI registry (on server) 



1 Swvka 









Client calls get5crviceList() on the stub. The Serw'\ctSer>^&r 
returns an arra^ of services 

Service Browser Server 
(client) - ^ge rServlceListQ- 




*0K, heres art array of services 



Client displays the list of services in a GUI 



Service Browser 
(client) 



Server 
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universal service brov^/ser 

How it works, continued... 



^ User selects from the list, so client calls the gctServiceQ 
method on the remote service. The remote service returns a 
serialized object that is an actual service that will run inside 
the client browser. 




^ Client calls the get&uiPanelQ on the serialized service object it 
just got from the remote s^r^ic^. The SUI for that service is 
displayed inside the browser, and the user can interact with it 
locally. At this point, we don't need the remote service unless/until 
the user decides to select another service. 

Service Browser 



(client) 
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The classes and interfaces: 



interface Sery\ceServer implements Remote 

A regular old RMI remote interface for the remote service (the 
remote service has the method for getting the service list and 
returning a selected seryict). 

class ServlceServcrlmpI implements Serv\ceServer 

The Qctuol ftMI remote service (extends UntcastRemoteObject). 
Its job (S to Instantiate and store all the services (the things 
that will be shipped to the client), and register the server /tself 
(ServiceServerlmpl) with the RMI registry. 



class Service Brciivser 

The client. It builds a very simple GUI, does a lookup in the RMI 
regf^ry to get the ServiceServer stub, then colls a remote method on 
if to get the list of services to display ir\ the &U1 list. 



interface Service 

This is the key to everything. This very s/mple interface has just one 
method, getSijiPanelQ. Every service that gets shipped over to the 
client mast implement this interface. This is what makes the whole thing 
UNIVERSAL! By implementing this interface, a service can come over 
even though the client has no idea what the actual class (or classes) 
are that make up that service. All the clieiit knows is that whatever 
comes over, it implements the Service interface, so it MUST have a 
getSuiPanelQ method. 

The client gets a serialized object as a result of calling 
getService(selectedSvc) on the StrviceSerwer stub, and all the client 
says to that object is, "I don't know who or what you are, but I bO 
know that you implement the Service interface, so I know I can calf 
get^uiPanelO on you. And since get^iPanelQ returns a JPaneL Til just 
slap it into the browser GUI and start interacting with iti 



doss bic^Scnfice implen:\ents ServJce 

Got dice? If not, but you need some, use this service to roll anywhere 
from 1 to 6 virtual dice for you. 

dcss MmlMusicServfce implements Service 

Remember that fabulous little 'music video' program from the first 
SUI Code Kitchen? We've turned it into a service, and you can play it 
over and over and over until your roommates finolly leave. 




gelServicasListO 
geiServiceO 



S«rvlceServertmpl 



gefServicesListO 
getServiceO 





DiceServlce 



gelGulPanelO 



doss boyOfTheWeekService implements Service 

Were you born on a Friday? Type in your birthday and find out. 



DayOfTheWeekSfin/lce 



getGuiPanelO 



MInlMuslcSorvIca 



getGulPanelO 
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universal service code 



interface ServiceServer (the remote interface) 

ixnport java . rnd . * ; ^^^^ 
public interface ServiceServer extends Remote { j^iws t^* !u l^^/* 

Object [] getServiceList () throws RemoteException ; rt^^^ 
Service getService (Object serviceKey) throws RemoteException; 



interface Service (wiiat tiie GUI services implement) 



in5>ort javax. swing.* ; 
import java.io.*; 

public interface Service extends Serializable { 
pxiblic JPanel getGuiPanel () ; 

} 
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s ServiceServerlmpI (the remote Implementation) 



art java . rmi . * ; 
art java>util.*; 
Drt java . rmi .server . 



oXic class ServiceSorverlmpl aattends DnicastRomoteObject iiE?>lQ£ments ServicaServdr { 



HashMap aarvicdliist; 



obi 



public SezvlceServarlnpl 0 throws RemoteExcaption { 

private void aetUpSarvieasO { wcrsaUt*-^'^**!^ 
servicdLiat = new HashMap (); ^'"""^ 
serviceI>ist.put("Dica Rolling Service", new DiceService (] ) ; 
8ervieeIiist.pufc("Day of the Week Service", new DayOfThaHeekService () ) ; 



serviceList. put (''Visual Music Service", new HiniMusicService () ) ; 



) 




(the 3tW^^''" 



public Object!] getServiceList () { 
System, out. println C'in remote") ; 
return serviceList.keySetO , toArray () 



) 



Client t,lUiM)s i. o.de.t,.^,,i , 

^ ■ *r "l^dt .>«e;, IVe 

't by d^ll.^g 3dAr^-v^^eO. 



public Service getServica (Object serviceKey) throws RemctetException { 



Service thoService = 
return theServioe; 



(Service) serviceU-St ,get (serviceKey) ; ^^^^ 



pxiblic static void main (String [] arga) { 
try { 

Naming . rebind ( ''ServiceServer " , new ServieaServerlnpl ( ) ) ; 
} catch (Exception ex) ( 
ex.printStacJcTrace () ; 

} 

System, ou t, print In (^^Remote service is running"); 



ServiceBrowser code 

class ServiceBrowser (the client) 

ixoport: java,awt.*; 

in^wrt j avax. swing. *; 

import jAva . rmi . ; 

iinport j ava. awt. event.*; 



public class SarvicoBrowaar { 

JPanel mainPanal ; 
JComboBox serviceList; 
Seirvica Server server; 



public void buildGUIO { 

JFraine frame = new JFraroe<^'RMI Browser") ; 
inainPanel ° new JPanel(); 

f rame . getCon tent Pane 0 .add (Bo rderLayout. CENTER, mainPanel) ; 



f rasie , getContentPane ( ) . add {BorderLayout . NORTH , serviceliiat) ; 

serviceList. addActionL is tener (new MyListListaner () ) ; 

franie.setSize(500,500) ; 
fraine.aetVi6ible(true) ; 



Qbjeat[] aervicea = getServicesList () ; 



serviceList = new JComboBox (services) ; 





void loadService (Object serviceSelection) ( 
try { 

Service svc = server . getService (serviceSelection) ; 
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Object [] getServicesList () { 
Object obj = null; 
Object [] services = null; 



} 



Po tV.e RMI ^^^^^ 



obj = Naming. lookup("rmi://127. 0. 0. 1/ServiceServer") ; 

} 

catch (Exception ex) { 
ex . printStackTrace { ) ; 

} 

server = (ServiceServer) obj; 



try { 

services = server .getServiceList() 

} catch (Exception ex) { 
ex, printStackTrace 0 ; 

) 

return services; 



^etScrvidcLisiO Jives \AS iht avvay Objcdis, 
hat we display in iKe JComboBot -fcnr -tKc user to 



class MyListListener implements ActionListener { 
public void actionPerf ormed (ActionEvent ev) { 

Object selection = serviceList .getSelectedltemO ; 
loadService (selection) ; 



} 



piablic static void main (String [] args) 
new ServiceBrowser 0 .buildGUI () ; 

} 



or 
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DiceService code 



class DiceService (a universal service, implements Service) 



import javax . awing. * ; 
import java .awt.avent . * , 
import java.io,*; 



public class DiceService implamenta Service { 



Jtiabel label; 
JCoidboBox numOfDice; 



public JPanel getGuiPanel () { 
JPanel panel = now JPanel () ; 
JButton button = new JButton (""Roll 
StringC] choices = ("1", "2", "3", 
numOfDice = new JComboBox (ohoices) ; 
label = new JLabel (''dice values here") ; 
button.addActlonListaner (new RollEmLiatener () ) 
panel . add (numOfBice) ; 
panel . add (button) ; 
panel. add (label) ; 
return panel; 




i 



public class RollEmListenar inplemanta ActionListener 
public void actionParf orniad(ActioiiEvant ev) ( 
// roll the dice 
String diceOiitput = 

String selection = (String) numOfDica . getSelectedltem ( ) ; 
int numOfDiceToRoll = Integer .paraeint (selection) ; 
for (int i = 0; i < nmnOfDiceToRoll; i-H-) ( 

int r = (int) ( (Math, random () * 6) + 1) ; 

diceOutput += r + r) ; 

) 

label . setText (diceOutput) ; 



^\ct^d loaded. Yc^ do wK.^.^ 




arpen your pencil 



Think about ways to improve the DiceService, One 
suggestion: using what you learned In the GUI chapters, 
make the dice graphical. Use a rectangle, and draw the 
appropriate number of circles on each one, corresponding 
to the roll for that particular die. 







• • 






• 






• • 
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class MInlMusicService (a universal service, implements Service) 

m 

import javax. soimd-TBiiiii . *; 
In^ort java.io.*; 
inyort j avax . mlng . * ; 
iHsport java.awt.*; 
Import java.awt.avant.*; 

public claas HlniMusicServicA implement 



MyDrawPanel myPanel; 

public JPanel g«tGuiPanal () { 

JPanal xnainPanal = nan JPanal () ; 
rayPan^l = new MyDrawPanel () ; 
JButton playltButton = new JButton 
playltButton . addActiotLLiataner (naw 
ma±nPanel.add(myPanal) ; 
mainPantel. add (playltButton) ; 
return mainPanel; 

} 



("Play it'') ; 
PlayltListanerO ) ; 




public class PlayXtLiatanar ln^demants ActionLiatener { Thh is all ihc musii. 

public void actionPorformBd (ActionEvent ev) ( Cede in c^^ai^ il, so wc 

try ( ^ 



Sequencer sequencer = MidiSystem.getSequencer () ; 
sequencer , open ( ) ; 



sequencer. addCott trollerEventLi a tener(myPanel, new int[] (127)); 
Sequence aeq = new Seqtience (Sequence . PPQ, 4) ; 
Track trac)c = seq. createTrac)t() ; 



tor (int i = 0; i < 100; i+= 4) { 



int rUum = (int) ( (Math, random () * 50) + 1) ; 

if (rN\m < 3B) { // so now only do it if num <38 (75% of the time) 
track, add (mayeEvent(144,l,rNuin, 100, i)) ; 
track. add (makeEvent( 176, 1,127,0,1) ) ; 
track, add (ma)ceEvent( 128, l,rNujn, 100, i + 2)); 

} 

) // end loop 



sequencer . aetJ3equence ( aeq) ; 
sequencer .start 0 ; 
sequencer. 8etTenpoInEPM( 2 20) ; 
) catch (Exception ex) (ox.printStackTrace () ; } 



) // close actionperfomied 
) // close innar class 
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MiniMusicService code 



class MiniMusicService, continued- 
public MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage () ; 
a. setMessage (coind, chan, one, two) ; 
event = new MidiEvent (a, tick) ; 

} catch (Exception e) { } 
return event; 
} 



class MyDrawPanel extends JPanel ixnplements ControllerEventListener { 

// only if we got an event do we want to paint 
boolean msg = false; 

public void con trolChange (ShortMessage event) { 



public void paintComponent (Graphics g) { 
if (msg) { 

Graphics2D g2 = (Graphics2D) g; 

int r = (int) (Math. random () * 250); 
int gr = (int) (Math . random () * 250); 
int b = (int) (Math . random ( ) * 250); 

g.setColor (new Color (r,gr,b) ) ; 

int ht = (int) ( (Math . random ( ) * 120) + 10); 
int width = (int) ( (Math , random ( ) * 120) + 10); 

int X = (int) ( (Math. random () * 40) + 10); 
int y = (int) ( (Math . random ( ) * 40) + 10); 

g . fillRect (x , y , ht , width) ; 
msg = false; 

} // close if 
} // close method 
} // close inner class 
} // close class 



public Dimension getPreferredSize () { 
return new Dimension (300, 300) ; 



msg = true; 
repaint ( ) ; 
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class DayOfTheWeekService (a universal service^ implements Service) 



import javax . swing . * ; 
in5>ort java.awt.avftnt.*; 
insert java . awt . * ; 
import java.io.*; 
import java.util.*; 
import java. text. * ; 

public class DayOfXheWaekServicQ implements Service { 



JLabel out^utLabel; 
JComboBox month; 
JTextField day; 
JTextFiald year; 



public JPanal getGuiPanel () ( 
JPanel panel = new JPanalO ; 
JButton button = new JButtonC'Do it!"); 
button.addActionliifltanar (new DoItLiatener () ) ; 
outputLabal = new JLabelC'data appears hara") ; 
DataFormatSymbols date Stuff = new DataFormatSymbola 
month ^ new JComboBox (da teS tuff , getMonths {)) ; 
day = new JTextField(8) ; 
year = new JTaxtFiald (B) ; 

JPanel inputPanel = new JPanel (new GridLayout (3 ,2) ) 

inputPanal.add(naw JLabel (''Month") ) ; 

inputPanel. add (month) ; 

inputPanel . add (new JLabal ( ''Day" ) ) ; 

inputPanel . add (day) ; 

inputPanel . add (new JLabal ( ''Year'' ) ) ; 

inputPanel. add (year) ; 

panel . add (inputPanel) ; 

panel . add (button) ; 

panel, add (outputLabel) ; 

return panel; 



0 ; 



} 



public claas DoItListenar in^Jlements ActionLifltenar { 
public void aationPerformed(ActionEvent ev) ( 
int monthKum = month .getSelectedlndex () ; 
int dayNum - Integer ,parselnt (day . getTextO ) ; 
int yearNum = Integer .parseint (year . gatTaxt () ) 
Calendar c - Calendar .get Instance () ; 
c . sat (Calendar . MONTH , monthNum) ; 
c . set (Calendar . DAY_OF_M0NTH , dayMum) ; 
c . set (Calendar . YEAR, yearNum) ; 
Date date = c.getTlme () ; 
String dayOfHeek = (new SinpleDateFormat ("EEEE 
outputLabal , setText (dayOfWeelc) ; 



")) .format (date) ; 



} 



} 
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the end... sort of 




ions! 

You matle it to tke enJL 



Of course, there's still the two appendices. 
And the Index. 

And then there's the web site... 
There's no escape, really. 



CoiMfratulat 
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Appendix A: 

Final Code Kitcketi ^ 



■■ crosed Hi-Hat □□gCGGSflQa^OGOMil 
; «>peivHl-Har □ QQ □ DQQ ODD □ Q □ D 
■ Acouf tic Snare O □ Cj □ □ D OG DO □ G G G GG 
; Crash cymbal D □ G □ GG O G GG G G OG OC 
Hind aap D G a G G G □ G G G G G G G BO 
:. High torn C GG G G O O O 0 Q GO □ □ OB ' 
:#Bo«go ■ CGGGGGGGGGGCSilMa 

^■iitenttu- ., ,,«oaaaa»o(9ograaGao 

whhtjt eGQaaGGGGOGGOQaG 

LowConfla ©BOBOBtfOBSSBSQGG 

cowb«ii GGGOaGQGGGGaGQGa 

; vibrasiap GQQQ Q B S Q Q QO'G □ Q Q G 

Uw»rmW Tom QQB BB^^^ 

;HighA«oflo GGGoadaGOQGOQaQB 

■C^^ Hi Conj 



( stop y 

Tempo Down 5 
f icndit y 



danca beat 



Andy: groov* #2 
Chris: grocvo2 revised' 
NIgdl: danG6 beat 



Ftnally, tkc complete version tke BeatBox! 

It connects to a simple MusicServcr so tkat you can 
senct anJ receive Leat patterns witk otker clients* 



vo»rt- . I 
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final BeatBox code 



Final BeatBox client program 

Most of this code is the same as the code from the CodeKitchens In the previous 
chapters, so we don't annotate the whole thing again. The new parts include: 

GUI - two new connponents are added for the text area that displays incoming 
messages (actually a scrolling list) and the text field- 

NETWORKING - just like the SimpleChatClient in this chapter, the BeatBox now 
connects to the server and gets an Input and output stream. 

THREADS - again, just like the SimpleChatClient, we start a 'reader' class that 
keeps looking for incoming messages from the server. But instead of just text, the 
messages coming in include TWO objects: the String message and the serialized 
An-ayList (the thing that holds the state of all the checkboxes.) 

in5)ort java.awt.*; 
import javax . swing . * ; 
import java.io.*; 
import javax. soxand.midi.* ; 
import java.util,*; 
import j ava . awt . event . * ; 
import java.net.*; 
import j avax . swing . event . * ; 

piablic class BeatBoxFinal { 

JFrame theFrame; 
JPanel mainPanel; 
JList incomingList; 
JTextField userflessage; 
ArrayList<JCheckBox> checkboxList; 
int nextNum; 

Vector<String> listVector = new Vector<String> () ; 
String userName; 
ObjectOutputStream out; 
ObjectlnputStream in; 

HashMap<Str ing , boolean[]> otherSeqsMap = new HashMap<String, boolean []>(); 

Sequencer sequencer; 
Sequence sequence; 
Sequence mySequence = null; 
Track track; 



String [] instrumentNames = {"'Bass Drum", ''Closed Hi-Hat", ''Open Hi-Hat" , "Acoustic 
Snare", "Crash Cymbal", "Hand Clap", "High Tom", "Hi Bongo", "Maracas", "Whistle", 
"Low Conga", "Cowbell", "Vibraslap", "Low-mid Tom", "High Agogo", "Open Hi Conga"); 

int[] instruronts = {35,42,46,38,49,39,50,60,70,72,64,56,58,47,67,63}; 
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public static void main (String [] args) { 

new BeatBoxFinalO .startup (args [0] ) ; // args[0] is your user ID/screen name 

public void startup) (String name) { 1^ I • 7o \3va BcatBo^^f^mal i^cBasI^ 

userName = name; p>^»V J** 

// open connection to the server 
try { 

Socket sock = new Socket (^^127. 0.0.1", 4242); KfotWmc^ new- sei ^ i^e 

out ^ new ObjectOutputStream(sock.getOutputStream() ) ; * . ?. |/^^ ^^^^ ^^akc Ca^d 
in = new ObjectInputStream(sock.getInputStream() ) ; "^l^^y ^Ke reader "t^^^^d 

Thread remote = new Thread (new RemoteReader () ) ; 
remote, start 0 ; 
} catch (Exception ex) { 

System, out.prin tin (^'couldn't connect - you'll have to play alone."); 

} 

setl^MidiO ; 
buildGUIO ; 

} // close startup 

public void buildGUI () { ^^j ^^de> notWm^ now \sttt 

theFrame = new JFrzune (^'Cyber BeatBox") ; 
BorderLayout layout = new BorderLayout ( ) ; 
JPanel background = new JPanel (layout) ; 

background. setBorder (BorderFactory . createEmptyBorder (10 , 10 , 10 , 10) ) ; 



checkboxList = new ArrayList<JCheckBox>{) ; 

Box buttonBox ^ new Box (BoxLayout .y_AXIS) ; 
JButton start = new JButton ("Start") ; 
start. addActionListaner (new MyStartListener () ) ; 
buttonBox. add (start) ; 

JButton stop = new JButton ('"Stop") ; 

stop . addActionListener (new MyStopListener ( ) ) ; 

buttonBox . add ( s top ) ; 

JButton upTempo = new JButton (''Tempo Up") ; 
upTeicipo. addActionListener (new MyUpT^i^oListener () ) ; 
buttonBox. add (upTempo) ; 



JButton downTempo = new JButton (''Tempo Down") ; 
downTenpo. addActionListener (new MyDownTexopoListener () ) ; 
buttonBox . add (downTempo) ; 

JButton sendit = new JButton ("sendit") ; 
sendlt. addActionListener (new MySendListener () ) ; 
buttonBox. add (sendit) ; 



userMessage = new JTextField() ; 
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finat BeatBox code 



buttonBox. add(u8&rMe88ag«) ; 



lucoaingLlst ^ AiatO ^ 

lnco«ningIdst.aildIiistS«l«^tjbOTUBte l4pLi8tS«lectioi>Listan«£{} } ; 

lEiecttingLiat , «fttS«l.«c^otW>da (UotSaXvctionModaX . SXHaUE_SBX£CTlCil) ; 
JScrollPane thaList » n«ir JBcroll£>anft(lncofliiiigLl»t} ; 
btittonBcw . add (tlmLiat) ; 



Box namaBox = new Box(BoxLAyoiit. y_AXIS) ; 
for (int i = 0; i < 16; { 

ruuxhaBox.add(iidw I>ab«l(inatiiimantNan»s [i] ) ) 

} 

ba ckground. add (Bordor Layout. EAST, buttonBox) ; 
bacJcground. add (BordarLayout, WEST, nameBox) ; 

therraine.g«tContantPana() . add (background) ; 

GridLayout grid = new GridLayout (16, 16) ; 

grid.setVgap(l) ; 

grid,setHgap(2) ; 

mainPanel = new JPanel (grid) ; 

ba ckgr ound . add ( Bo r da r Lay out . CENTER , inainPane 1 ) 



I 



setter a ««saM *^«7> tK« I'rt 
load a«a p^Y ^« ^^^^^^ 



for (int i = 0; i < 256; i-H-) { 

JChacJcBox c = new JCheckBox() ; 

c.setSelected (false) ; 

checkboxList.add(o) ; 

mainPanel . add (c) ; 
) // end loop 



theFrame . aetBounda (50 , 50 , 300 , 300) ; 

thePrama .pack ( ) ; 

theFrame . sotViaible (true) ; 

) // close buildGOI 



public void setUpMidiO { 
try { 

aequencer « MidiSyatem.getSequencer () ; 
sequencer . open ( ) ; 

sequence « new Sequence (Sequence .PPQ, 4) 
track sequence . area teTrack 0 ; 
sequencer. aetTen^InBFM( 120) ; 
catch (Exception e) (e .prints tackT race () ; ) 



} // close setUpMidi 
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public void buildTrackAndStart {) { 

ArrayList<Integer> trackList = null; // this will hold the instruments for each 
sequence . deleteTrack (track) ; tVctkW^^^ 
track = sequence. createTrackO ; . , u.. ^,a\kw<K tV\irou^ .1 

for (int i = 0; i < 16; i++) { 

trackList = new ArrayList<Integer>() 




for (int j = 0; j < 16; j++) { 

JCheckBox jc = (JCheckBox) checkboxList.get ( j + (16*i) ) ; 
if ( jc.isSelectedO ) { 

int key = instruments [i] ; 

trackList . add (new Integer (key) ) ; 
} else ( 

trackList, add (null) ; // because this slot should be empty in the track 

} 

} // close inner loop 
makeTracks (trackList) ; 

} // close outer loop 

track.add(makeEvent(192,9,l,0, 15) ) ; // - so we always go to full 16 beats 
try { 

sequencer . setSequence (sequence) ; 

sequencer . setLoopCount (sequencer . L<X)P_CONTINUOUSLy) ; 
sequencer . start () ; 
sequencer . setTempoInBPM(120) ; 
} catch (Exception e) {e .prints tackTrace (); } 

} // close method 

public class MyStartListener implements ActionListener { 
pijblic void actionPerf ormed (ActionEvent a) { 
buildTrackAndStart 0 ; 

) // close actionPerformed -^x^ \\skA'^^^^' 

} // close inner class ^^ti\^ ^"^^ 



public class MyStopListener implements ActionListener { 
public void actionPerformed (ActionEvent a) { 
sequencer . stop ( ) ; 

) // close actionPerformed 
} // close inner class 

public class MyUpTeir5>oListener implements ActionListener { 
public void actionPerformed (ActionEvent a) { 

float tempoFactor = sequencer, getTempoFactor () ; 
sequencer. setTempoFactor( (float) (ten^oFactor * 1.03)); 

} // close actionPerformed 
) // close inner class 
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public class MyDownTenipoListener ixnpleroents ActionListener { 
public void actionPerformed(ActionEvent a) { 
float ten^oFactor = sequencer. getTen^Fac tor () ; 
sequencer. setTerapoFactor( (float) (tenpoFactor * .97)); 

} 

} 

public class M/SendListener implements ActionListener { 
public void actionPerf ormed (ActionEvent a) { 

// make an arraylist of just the STATE of the checkboxes 
boolean [] checkboxState = new boolean [256] ; 
for (int i = 0; i < 256; i++) { 

JCheckBox check = (JCheckBox) checkboxList.get (i) ; iCX^a^^t ^^^^ 

if (check. isSelectedO) { , \„t V.U t^c 

CheckboxState [i] = true ; • ^ -.j ^cy.- A* a "tf ■) a«A ^''^ ^ s 

} // Close loop '('^JJ sV-^ .essaj ^^^^ .Vea« 

string nessageToSend = null ; , oVjNetv ^ 

try { 

out.writeObject (userName + nextNum-l-+ + + userMessage.getText () ) ; 

out. writeObject (checkboxState) ; 
} catch (Exception ex) | 

System, out.println ('"Sorry dude. Could not send it to the server."); 

} 

userMessage.setText("") ; 

} // close actionPerformed 
} // close inner class 

public class MyListSelectionListener iit^lements ListSelectionListener { 
public void valueChanged (ListSelectionEvent le) { 
if ( ! le . getValuelsAdjusting ( ) ) { 

String selected = (String) incomingList.getSelectedValue () ; 
if (selected != null) { 

// now go to the map^ and change the sequence 

boolean[] selectedState - (boolean[]) otherSeqsMap. get (selected) ; 
changeSequence (selectedState) ; 
sequencer. s top () ; 
buildTrackAndStart () ; 

} 

} *^iS is 

} // close valueChanged ^*">er " 

// close inner class 
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piiblic class RemoteReader implements Runnable { 

boolean [] checlcboxState = null; A m 

String nameToShow = null; ^ iWyfcad — 

Object obj = null; F lJes^^^^^ K^'Vte^^^^^^^ 

public void runO { Wo^ . s^v^^aV^^^.^'TStern 

while { (obj=in. readObject 0 ) •= null) { Stv-\ys^ ^^f^ t^ctkbo^ ^^^"^ 

System. out. printlnC^ got an object from serv€^5f^?'^^ 
System. out. println(obj .getClass () ) ; 
String nameToShow = (String) cb j ; 

checkboxState = (boolean[]) in. readObject () ; ^ desert 1^^^^?^ ^op^ts 
otherSeqsMap.put<nameToShow, checkboxState); ^€ss^ ^ 

listvector. add (nameToShow) ; cheekt ^""^^^^ ^^^jC'^i^ ^^^^ 



incomingList.setListData(listVector) ; u . *tate va/tu* / ^ *^ BoqL^ 

} // close while k s / ' V^P^^enT /j''^ 

catch (Exception ex) {ex.printStackTrace () ; } A^'rf^P ^Wa- u i 3 ^ ^ J/ i 



) // close run 



> // Close inner class ^^'^^ W^^^^^^^^ 

public class MyPla^lineListener implements ActionListener { to dh^j^^ . s s^j^ 

public void actionPerformed(ActionEvent a) { ^ ^'^^ fe^. ^ 

if (mySequence ?= null) { 

sequence = mySequence; // restore to my original 

} 

} // close actionPerformed 
) // close inner class «^eiKod is taWtd wk*«. iL^ , . 

public void changeSequence (boolean [ ] checkboxSta«fs^9P the Paiie^-fi +^ 4^L ^ ^vf^^^n / tLy 
for (int i = 0; i < 256; i++) { ^ they sele^W 

JCheckBox check = (JChecJcBox) checkboxList.get (i) ; 
if (checkboxState [i] ) { 

check. setSelected (true) ; 
} else { 

check. setSelected (false) ; 

) // 'close loop A« tv>. mv\ ■« 

} // close ChangeSequence v^as m iKe frcvious vm»on. 



public void makeTracks (ArrayList list) { 
Iterator it = list . iterator () ; 
for (int i = 0; i < 16; i++) { 

Integer num = (Integer) it. next () ; 
if (num != null) { 

int numKey = num. intValue () ; 
track.add(makeEvent (144 , 9,nuniKey, 100, i) ) ; 
track.add(makeEvent (128, 9, numKey, 100, i + 1)); 

} 

} // close loop 
} // close makeTracks 0 
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public MidiEvent makeEvent (int comd, int chan, int one, int two, int tick) { 
MidiEvent event = null; 
try { 

ShortMessage a = new ShortMessage () ; 

a.setMessage(comd, chan, one, two); 

event = new MidiEvent (a, tick) ; 
}catch (Exception e) { } i VVte tV»c 

return event; (N(otWm^ *^e>N^ ^"^^ 

) // close makeEvent 

) // close class 




What are some of the ways you can improve this program? 
Here are a few Ideas to get you started: 

1) Once you select a pattern, whatever current pattern was playing Is blown 
away. If that was a new pattern you were working on (or a modification of 
another one), you're out of luck. You might want to pop up a dialog box that 
asks the user If he'd like to save the current pattern. 



2) If you fail to type in a command-line argument, you just get an exception 
when you run it! Put something in the main method that checks to see if 
youVe passed in a command-line argument. If the user doesn't supply one, 
either pick a default or print out a message that says they need to run it 
again, but this time with an argument for their screen name. 



3) It might be nice to have a feature where you can click a button and it 
will generate a random pattern for you. You might hit on one you really like. 
Better yet, have another feature that lets you load in existing 'foundation' 
patterns, like one for jazz, rock, reggae, etc. that the user can add to. 

You can find existing patterns on the Head First Java web start. 
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Final BeatBox server program 

Most of this code is identical to the SimpleChatServer we made in the 
Networking and Threads chapter. The only difference, in fact, is that this server 
receives, and then re-sends, two serialized objects instead of a plain String 
(although one of the serialized objects happens to be a String). 



import java.io.*; 
import java.net.*; 
import java.util.*; 

piiblic class MusicServer { 

ArrayList<Ob jectOutputStreain> clientOutputStreeuns ; 

public static void main (String [] args) { 
new MusicServer 0 ,go() ; 

} 

public class ClientHandler iiE^lements RunncUsle { 

ObjectlnputStream in; 
Socket clientSocket; 



public ClientHandler (Socket socket) { 
try { 

clientSocket = socket; 
in = new ObjectInputStream(clientSocket.getInputStream() ) ; 

} catch (Exception ex) { ex . printStackTrace ( ) ; } 

} // close constructor 



public void run() { 

Object o2 = null; 
Object ol = null; 
try { 

while ((ol = in.readObjectO) t= null) { 
o2 = in.readObjectO; 

System. out.pr in tin ("read two objects") ; 
tellEveryone (ol , o2) ; 

} // close while 

} catch (Exception ex) { ex. prints tackTrace () ;} 

} // close run 
} // close inner class 
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public void go() { 

clientOutputStreams = new ArrayList<0bjectOutputStreain>() ; 

try { 

ServerSocket serverSock = new ServerSocket (4242) ; 

while (true) ( 

Socket clientSocket = server Sock . accept ( ) ; 

ObjectOutputStream out = new ObjectOutputStream(clientSocket.getOutputStream() ) 
ClientOutputStreams. add (out) ; 

Thread t = new Thread (new ClientHandler (clientSocket) ) ; 
t. start 0 ; 

System. out. println ('"got a connection") ; 

} 

} catch (Exception ex) { 
ex.printStackTraceO ; 

} 

} // close go 

public void tellEveryone (Object one^ Object two) { 
Iterator it = clientOutputStreams . iterator () ; 
while (it. hasNextO ) { 
try { 

ObjectOutputStream out = (ObjectOutputStream) it.nextO ; 
out.writeObject (one) ; 
out.writeObject (two) ; 
} catch (Exception ex) { ex . printStackTrace ( ) ; } 

} 

} // close tellEveryone 
} // close class 
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The Top Ten Topics that almost made it into the Real Book... 




We covered a lot of ground, and you're almost finished with this book. We'll miss you, but before 
we let you go, we wouldn't feel right about sending you out Into JavaLand without a little more 
preparation. We can't possibly fit everything you'll need to know into this relatively small appendix. 
Actually we did originally include everything you need to know about Java (not already covered by 
the other chapters), by reducing the type point size to .00003. It all fit, but nobody could read it. So, 
we threw most of it away, but kept the best bits for this Top Ten appendix. 

This really h the end of the book. Except for the index (a must-readi). 
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#10 Bit Manipulation 

Wbydoyoi/ care? 

We've talked about the fact that there are 8 bits in a byte, 
16 bits in a short, and so on. You might have occasion to 
turn individual bits on or off. For instance you might find 
yourself writing code for your new Java enabled toaster, 
and realize that due to severe memory limitations, certain 
toaster settings are controlled at the bit level. For easier 
reading, we're showing only the last 8 bits in the comments 
rather than the full 32 for an int). 

Bitwise NOT Operator: ~ 

This operator 'flips all the bits' of a primitive. 

int X = 10; // bits are 00001010 
X = -x; // hits are now 11110101 

The next three operators compare two primitives on a bit 
by bit basis, and return a result based on comparing these 
bits. We'll use the following example for the next three 
operators: 

int X = 10; // bits are OOQOlOlO 
int y = 6; // bits are 00000110 

Bitwise AND Operator: & 

This operator returns a value whose bits are turned on only 
if both original bits are turned on: 

int a = X & y; // bits are 00000010 

Bitwise OR Operator: | 

This operator returns a value whose bits are turned on only 
if either of the original bits are turned on: 

int a = X j y; // bits are 00001110 

Bitwise XOR (exclusive OR) Operator: ^ 

This operator returns a value whose bits are turned on only 
if exactfy one of the original bits are turned on: 

int a = X ^ y; // bits are 00001100 



The Sliift Operators 

These operators take a single integer primitive and shift (or 
slide) all of its bits in one direction or another. If you want 
to dust off your binary math skills, you might realize that 
shifting bits lefi effectively multiplies a number by a power of 
two, and shifting bits right effectively divides a number by a 
power of two. 

We'll use the following example for the next three operators: 

int X = '11; // bits are 11110101 

Ok, ok, we've been putting it off, here is the world's 
shortest explanation of storing negative numbers, and 
two's complement Remember, the leftmost bit of an integer 
number is called the sign bit A negative integer number in 
Java alwaysh^s its sign bit turned on (i.e. set to 1). A positive 
integer number always has its sign bit turned off{Q), Java 
uses the two's complement iormul^ to store negative numbers. 
To change a number's sign using two's complement, flip all 
the bits, then add 1 (with a byte, for example, that would 
mean adding 00000001 to the flipped value). 

Riglit Sliift Operator: » 

This operator shifts all of a number's bits right by a certain 
number, and fills all of the bits on the left side with whatever 
the original leftmost bit was. The sign bit does not change: 

int y = X » 2; // bits are 11111101 

Unsigned Right Shift Operator: »> 

Just like the right shift operator BUT it ALWAYS fills the 
leftmost bits with zeros. The sign bit might change: 

int y = X »> 2; // bits are 00111101 

Left Shift Operator: « 

Just like the unsigned right shift operator, but in the other 
direction; the rightmost bits are filled with zeros. The sign bit 
might change. 

int y = X « 2; // bits are 11010100 
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#9 Immutability 

Why do yoa care that Strinqj are IniJMOtablet 

When your Java prograias start to get big, youMl 
inevitably end up with lots and lots of String objects, 
For security purposes, and for the sake of conserving 
memory (remember your Java programs can run on 
teeny Java-enabled cell phones), Strings in Java are 
immutable. What this means is that when you say: 

String 9 = '^O"; 

for (int X = 1; X < 10; x-t-h) { 

B = S -h X; 

) 

What's actually happening is that you're creating ten 
String objects (with values "OT, "012", through 
''0123456789"). In the end 5 is referring to the String 
with die value "0123456789", but at this point there 
are ten Strings in existence! 

Whenever you majce a new String, the JVM puts it 
into a special pan of memory called the 'String Pool' 
(sounds refreshing doesn^i it?). If there is already 
a String in the String Pool with the same value, the 
JVM doesn't create a duplicate, it simply refers your 
reference variable to the existing entry. The JVM can 
get away with this because Strings are immutable; one 
reference variable can*t change a String's value out 
from under another reference variable referring to 
the same String. 

The other issue with the String pool is that the 
Garbage Collector doesn't go there. So in our example, 
unless by coincidence you later happen to make a 
String called "01234", for instance, the first nine 
Strings created in our /arloop will just sit around 
wasting memory. 

How does this save memory? 

Well, if you're not careful, itdoesn'tl But if you un- 
derstand how String immutability works, than you 
can sometimes take advantage of it to save memory. 
If you have to do a lot of String manipulations (like 
concatenations, etc.)j however, there is another class 
StringBuilder, better suited for that purpose, We'll 
talk more about StringBuilder in a few pages, 



Why do you care that Wrappers are 
Immutable? 

In the Math chapter we talked about the two main 
uses of the wrapper classes: 

• Wrapping a primitive so it can pretend to be an 
object. 

• Using the static utility methods (for example. 
Integer. parselntO). 

It's important to remember that when you create a 
wrapper object like: 

Integer iWrap = new Integer (42) ; 

Thai's it for that wrapper object. Its value will always 
be 42. There is no setter method for a wrapper object 
You can, of course, refer iWrap to a rfZ/jf^rm/ wrapper 
object, but then you'll have two objects. Once you 
create a wrapper object, there's no way to change 
the vahmo£&\2i\ object! 
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#8 Assertions 



We haven't talked much about how to debug your Java 
prograra while you're developing it We believe that 
you should leam Java at the command line, as we've 
been doing throughout the book. Once you're a Java 
pro, if you decide to use an IDE*, you might have 
other debugging tools to use. In the old days, when 
a Java programmer wanted to debug her code, she*d 
stick a bunch of System,out.prindn( ) statements 
throughout the program, printing current variable 
values, and "I got here" messages, to see if the flow 
control was working properly. (The ready-bake code 
in chapter 6 left some debugging 'print' statements 
in die code.) Then, once the program was working 
correctly, she'd go through and take all those System. 
out.prindn{ ) statements back out again. It was 
tediotis and error prone. But as of Java 1 .4 (and 5.0), 
debugging got a whole lot easier The answer? 

Assertions 

Assertions are like System.ouLprindn( ) statements 
on steroids. Add diem to your code as you would 
add prindn statements. The Java 5.0 compiler 
assumes you'll be compiling source files that are 5-0 
compatible, so as of Java 5.0, compiling with assertions 
is enabled by default. 

At nmdme, if you do nothing, the assert statements 
you added to yotu: code will be ignored by the JVM, 
and won't slow down your program. But if you tell the 
JVM to enable your assertions, they will help you do 
your debugging, without changing a line of code! 

Some folks have complained about having to leave 
assert statements in their production code, but 
leaving them in can be really valuable when your 
code is already deployed in the field. If your client 
is having trouble, you can instruct the client to run 
the program with assertions enabled, and have the 
client send you the output. If the assertions were 
stripped out of your deployed code, you'd never 
have that option. And there is almost no downside; 
when assertions are not enabled, they are completely 
ignored by the JVM, so there's no performance hit to 
worry about. 



How to make Assertions work 

Add assertion statements to your code wherever you 
believe that something mmt be true. For instance: 

assert (height > 0) ; 

// if true, program continues norraally 
// if false, throw an AssertionError 

You can add a litde more information to the stack 
trace by saying: 

assert (height > 0) : ''height = + 
height + weight weight; 

The expression after the colon can be any legal 
Java expression ihat resolves to a non-nuU value. But 
whatever you do, don't create assertions thai change an 
object's state! If you do, enabling assertions at nmtime 
might change how yoiu" program performs. 

Compiling and running with 
Assertions 

To aympileynih assertions: 

javac TestDriveGame . java 

(Notice that no command line options were 
necessary.) 

To runwvxh assertions: 

java -ea TestDriveGajne 



* IDE siaudx for Integrated Development En\'ironment 
and includes tools such as Eclipse, Borland^s JBoilder, or 
the open source NetBeans (netbeans.org). 
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#7 Block Scope 

In chapter 9, we talked about how local variables 
live only as long as the method in which they're 
declared stays on the stack. But some variables can 
have even shorter lifesp2ins. Inside of methods, we 
often create blocks of code. We've been doing this 
all along, but we haven't explicidy talked in terms of 
blocks. Typically, blocks of code occur within methods, 
and are bounded by curly braces { }. Some common 
examples of code blocks that you'll recognize include 
loops (for, while) and conditional expressions (like if 
statements). 

Let's look at an example: ^ 

void doStuff 0 {c J L IL, *«4-iv€ wrtiW 

for (int y - 0; y < 5; y++) , 



end iKc -f <wr toof blodk 

In the previous example, y was a block variable, 
declared inside a block, and went out of scope as 
soon as the for loop ended. Your Java programs will 
be more debuggable and expandable if you use local 
variables instead of instance variables, and block 
variables instead of local variables, whenever possible. 
The compiler will make sure that you don't try to use 
a variable that's gone out of scope, so you don't have 
to worry about runtime meltdowns. 
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#6 Linked Invocations 



While you did see a litde of diis in this book, we tried to keep our syntax as clean and 
readable 3s possible. There are, however, many legal shortcuts in Java, that you'll no doubt 
be exposed to, especially if you have to read a lot code you didn't write. One of the more 
common constructs you will encounter is known as linked invocations. For example: 

StringBuffer sb = new StringBuff er ( "spring" ) ; 

sb = sb.deiete (3^ 6) . insert (2, "umme") .deleteCharAt (1) ; 

System. out .println ("sb = " + sb) ; 

// result is sb = summer 

What in the world is happening in the second line of code? Admittedly, this is a contrived 
example, but you need to learn how to decipher these. 

1 - Work from left to right. 

2 - Find the result of the leftmost method call, in this case sb . delete (3,6), If you 
look up StringBuffer in the API docs, you'll see that the delete ( ) method returns a 
StringBuffer object. The result of running the delete ( ) method is a StringBuffer object 
with the value "spr". 

3 - The next leftmost method (insert ( ) )is called on the newly created StringBuffer 
object "spr". The result of that method call (the insert ( ) method), is also a StringBuffer 
object (although it doesn't have to be the same type as the previous method return), and so 
it goes, the returned object is used to call the next method to the right. In theory, you can 
link as many methods as you want in a single statement (although it's rare to see more than 
three linked methods in a single statement). Without linking, the second line of code from 
above would be more readable, and look something like this: 

sb = sb.delete (3, 6) ; 

sb = sb. insert (2, "umme") ; 

sb = sb.deleteCharAt (1) ; 

But here's a more common, and useful example, that you saw us using, but we thought 
we'd point it out again here. This is for when your main() method needs to invoke an 
instance method of the main class, but you don't need to keep a reference to the instance of 
the class. In other words, the main() needs to create the instance only so that main() can 
invoke one of the instance's methods, 

class Fog { 



public static void main (String [] args) [ 




// here's what we REALLY want... 
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#5 Anonymous and Static Nested Classes 



Nested classes come In many flavors 

In the GUI event-handling section of the book, we started using inner (nested) classes as a 
solution for implementing listener interlaces. That's the most cormnon, practical, and read- 
able form of an inner class — where the class is simply nested within the curly braces of another 
enclosing class. And remember, it means you need an instance of the outer class in order to get 
an instance of the inner class, because the intier class is a me^nbero^the outer/enclosing class. 

But there are other kinds of inner classes including static znd anonymous. We're not going 
into the details here, but we don't want you to be thrown by strange syntax when you see it in 
someone's code. Because out of virtually anything you can do with the Java language, perhaps 
nothing produces more bizarre-looking code than anonymous inner classes. But we'll start with 
something simpler — static nested classes, 

static nested classes 

You already know what static means — something tied to the class, not a particuJar instance. A 
static nested class looks just like the non-staoc classes we used for event listeners, except they're 
marked with the keyword static. 



public class FooOuter { 
^^^^^ class Barlnner { 
void aayltO { 



System. out. priiitln(^^thod of a static inner class''); 



} 




class Test 

public static void main^ 

foo . saylt () ; 



Static nested classes are more like regular non-nested classes in that they don't enjoy a special relation- 
ship with an enclosing outer object. But because static nested classes are sull considered a member of 
the enclosing/ outer class, they still get access to any private members of the outer class... but only the 
ones that are also sialic Since the static nested class isn't connected to an instance of the outer class, it 
doesn't have any special way to access the non^stadc (instance) variables and methods. 
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when arrays aren't enough 

#5 Anonymous and Static Nested Classes, continued 

The difference between nested and inner 

Anyjava class that's defined within the scope of another class is known as a nested class. It 
doesn't matter if it*s anonymous, static, normal, whatever. If it's inside another class, it's 
technically considered a imt^d class. But non-static nested classes are often referred to as inner 
classes, which is what we called them earlier in the book. The bottom line: all inner classes are 
nested classes, but not aD nested classes are inner classes. 

Anonymous inner classes 

Imagine you're writing some GUI code, and suddenly realize that you need an instance 
of a class that implements Actionlistenen But you realize you don't havezn instance of an 
ActionListener Then you realize that you also never wrote a class for that listener You have two 
choices at that point: 

1) Write an inner class in your code, the way we did in our GUI code, and then instantiate it 
and pass that instance into the button's event registration (addActionListener()) method. 



2) Create an anonymous '\r\TitT class and instandate it, right there, just-in-time. LUeraUy rig^ 
whereyouare at the point you need the listener object That*s right, you create the class and the 
instance in ,the place where you'd normally be supplyingjust the instance. Think about that for 
a moment — it means you pass the entire cUissv/here you*d normally pass only an instance into a 
method argument! 



OR 



import java . awt. event. *; 
import, javax. swing-*; 
public class TestAnon { 




public static void main (Stringd args) ( 



button .addAct ion Listener 



JTrame frame = new JFrameO; 1/ 
JButton button = new JButton ("click") ; Y 
frame.getContentPane 0 .add (button) ; J 
// button. addActionListener (quitListener) ; 
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#4 Access Levels and Access Modifiers (Who Sees Wiiat) 



Java has four access levels and three access modifiers. There are only three modifiers because 
the default (what you get when you don't use any access modifier) is one of the four 
access levels. 



Access Levels (in order of how restrictive they are, from least to most restrictive) 



public ^ 
protected 
default 
private 



j>uWid means any dode anywhere dan addess iKe fublid thinj (by 
ihinft' we mean dlass; variable^ method, donstrudtor, etd )- 



— frotedted works y^i like default (dode in the same fadkage has addess), EXCEPT it 
also allows subdiasses outside the fadkage to inherit the frotedted thing. 

de-fault ^ttts^ means that only dode within the same fadkage as 
the with the de-fault thing dan addess the de-fault thing. 

frivate means that only dode within the same t\As% dan dtu%'^ the frivatc thing, 
^eef in mind it means frivate to the diass, not frivate to the objedt (?ne Pog 
dan see another Pog objedt's frivate stuWj but a Cat dan t see a Dogs frivates. 



Access modifiers 



public 

protected 

private 



Most of the time you'll use only public and private access levels, 
public 

Use public for classes, constants (static final variables), and methods that you're 
exposing to other code (for example getters and setters) and most constructors. 

private 

Use private for virtually all instance variables, and for methods that you don't want 
outside code to call (in other words, methods used by the public methods of your class) . 

But although you might not use the other two (protected and default), you still need to 
know what they do because you'll see them in other code. 
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#4 Access Levels and Access Modifiers, cont. 

default and protected 

default 

Both protected and defeuJt access levels are tied to packages. Default access is simple — it 
means that only code vnlhin the same package csiri access code with default access. So a 
defeult class, for example (which means a class that isn*t explicitly declared as public) can 
be accessed by only classes within the same package as the default class. 

But what does it really mean to access a class? Code that does not have access to a class is 
not allowed to even think zbout the class. And by think, we mean use the class in code. 
For example, if you don't have access to a class, because of access restriction, you aren*t 
allowed to instantiate the class or even declare it as a type for a variable^ argument, or 
return value. You simply can't type it into your code at alll If you do, the compUer will 
complain. 

Think about the implications — a default class with public methods means the public 
methods aren^t really public at all. You can^t access a method if you can't see the class. 

Why would anyone want to restrict access to code within the same package? Typically, 
packages are designed as a group of classes that work together as a related set. So it might 
make sense that classes within the same package need to access one another's code, while 
as a package, only a small number of classes and methods are exposed to the outside 
world (i.e. code outside that package). 

OK, that's default. It's simple— if something has default access (which, remember, means 
no explicit access modifier!), only code within the same package as the default thing 
(class, variable, method, inner class) can access that thing. 

Then what's proUcted for? 
protected 

Protected access is almost identical to default access, with one exception; it allows sub- 
classes to inherit the protected thing, even if those subclasses are outside the parage of the sniper- 
class they extend That's it. Thafs all protected buys you — the ability to let your subclasses 
be outside your superclass package^ yet still inherit pieces of the class, including methods 
and constructors. 

Many developers find very little reason to use protected, but it is used in some designs, 
and some day you might find it to be exactly what you need. One of the interesting things 
about protected is that — unlike the other access levels — protected access applies only to 
inheritance, [fa subclass^utside-the-package has a reference \o an instance of the superclass 
(the superclass that has, say, a protected method), the subclass can't access the pro- 
tected method using that superclass reference! The only way the subclass can access that 
method is by inheritingit. In other words, the subclass-outside-ihe-package doesn't have 
access to the protected method, it just has the method, through inheriunce. 
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#3 String and StringBuffer/StringBuilder Methods 



Two of the most commonly used classes in the Java API are String and StringBuffer (remember from 
#9 a few pages back, Strings are immutable, so a StringBuffer/StringBuilder can be a lot mor efficient 
if you're manipulating a String). As of Java 5.0 you should use the StnngBuilder cIslss instead of 
StringBuffer, unless your String manipulations need to be thread-safe, which is not common. Here's a 
brief overview of the key methods in these classes: 

Both String and StringBuffer/StringBuilder classes have: 

char charAt(int index) ; / / what char is at a certain position 

int length ( ) ; // how long is this 

String substring (int start, int end); // get a part of this 

String toString () ; // what's the String value of this 

To concatenate Strings: 
String concat(string); 

String append (String); 



/ / for the String class 

// for StringBuffer Be StringBuilder 



The String class has: 

String replace (char old, char new); 

String substring(int begin, int end); 

char [] toCharArrayO; 

String toLowerCase(); 

String toUpperCaseO; 

String trim(); 

String valueOf(char []) 

String valueOf(int i) 



/ / replace all occurences of a char 

/ / get a portion of a String 

/ / convert to an array of chars 

/ / convert all characters to lower case 

// convert all characters to upper case 

// remove whitespace from the ends 

// make a String out of a char array 

/ / make a String out of a primitive 

// other primitives are supported as well 



The StringBuffer Csf StringBuilder classes have: 

StringBxxxx delete (int start, int end); // delete a portion 

StringBxxxx insert(int offset, any primitive or a char [] ) ; // insert something 
StringBxxxx replace (int start, int end. String s); // replace this part with this String 

StringBxxxx reverse (); // reverse the SB from front to back 

void setCharAt(int index, char ch); // replace a given character 

Note: StringBxm: refers to either StringBuffer or StringBuilder, as appropriate. 
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#2 Multidimensional Arrays 

In most languages, if you create, say, a 4 x 2 two-dimensional airay, you would visualize a 
rectangle, 4 elements by 2 elements, with a total of 8 elements. But in Java, such an array 
would actually be 3 arrays linked together) In Java, a two dimensional array is simply an array 
of arrays. (A three dimensional array is an array of arrays of arrays, but we'll leave that for 
you to play with.) Here's how it works 

intl) (] a2d = new int [4] [2J ; 

The JVM creates an array with 4 elements. Ea4:h of these four elements is actually a reference 
variable referring to a (newly created), int array with 2 elements. 




Working with multidimensional arrays 

-To access the second element in the third array: int x = a2dt2)[l); // remembery 0 based! 
-To make a onedimensional reference to one of the sub-arrays: int[l copy = a2d[l); 

- Shortcut initialization ofa2x3array: int ( 1 ( ) x = ( ( 2, 3, 4 ( , ( 7,8,9 } 1; 

- To make a 2d array vdth irregul2ur dimensions: 

int[l II y = new int [2] [); // makes only the first array^ with a length of 2 
y(0] = new int (31; // makes the first sub-array 3 elements in length 
y(l] = new int (51; // makes the second sub-array 5 elements in length 
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And the number one topic that didn't quite make it in... 

#1 Enumerations (also cailed Enumerated Types or Enums) 



We've talked about constants that are defined in the API, for instance, 
JFraine.EXIT_ON_CLOSE. You can also create your own constants by 
marking a variable static final. But sometimes you'll want to create a set 
of constant values to represent the only vahd values for a variable. This set of 
valid values is commonly referred to as an enumeration. Before Java 5.0 you 
could only do a half-baked job of creating an enumeration in Java. As of Java 
5.0 you can create full fledged enumerations that will be the envy of all your 
prejava 5.0-using friends. 

Who's in the band? 

Let's say that you're creating a website for your favorite band, and you want to 
make sure that all of the comments are directed to a particular band member. 

The old way to fake an "enum": 

public static final int JERRY = 1; 
public static final int BOBBY = 2; 
public static final int PHIL = 3; 



// do JERRY related stuff 

} 



The good news about this technique is that it DOES make the code easier to 
read. The other good news is that you can't ever change the value of the fake 
enums you've created; JERRY will always be 1. The bad news is that there's 
no easy or good way to make sure that the value of selectedBandMember 
will always be 1, 2, or 3. If some hard to find piece of code sets 
selectedBandMember equal to 812, it's pretty likely your code will break... 




iVcVc Kopmj that by the time we jot here 
Vle^tedBand/Vlembev-" has a valid value' 



if (selectedBandMember 



== JERRY) { 
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#1 Enumerations, cont. 



The same situation using a genuine Java 5.0 enum. While this is a very basic 
enumeration, most enumerations usually are this simple. 



A new, official "enum": 

public enum Members { JERRY, BOBBY, PHIL }; 
public Members selectedBandMember ; 

// later in the code 

if (selectedBandMember == Memibers , JERRY) { 
// do JERRY^related stuff '^V^ 

No hced b> woinry about this vav^iable's vaW/ 



The ''^iuitdda^dMcr^htr' vaviabic is of type 
''fi/lt^\>tts!\ ayvd dah OKL/ y,ave a value of 



The syntax to refer to an enu**. ^«stahdc'^ 



Your enum extends java.lang.Enum 

When you create an enum, you're creating a new class, and you're implicitly extending 
java . lang.EnuBL You can declare an enum as its own standalone class, in its own 
source file, or as a member of another class. 



Using ""if " and ""switch" with Enums 

Using the enum we just created, we can perform branches in our code using either 
the if or switch statement. Also notice that we can compare enum instances using 
either or the , equals ( ) method. Usually == is considered better style. 



Assijnm^ ah Chum value to a variable- 
Members n = Members -BOBBY ; 
if (n . equals (Members , JERRY) ) System, out .print In ('Verrrry ! " ) ; ^ ^-^^^1 

if (n Member S.BOBBY) System, out . println ( ^^Rat Dog''); r^-.«__. «^ ^^^^ '^'^ 

Members ifName = Members . PHIL; 
switch { i f Name ) { 

case JERRY: System, out . print (''make it sing '') ; 

case PHIL: System. out .print (''go deep ") ; ^ ^ P<^P WAxat's tKe output? 

case BOBBY: System . out . println ("Cassidy ! ") ; 



Answer: 
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#1 Enumerations, completed 

A really tricked-out version of a similar enum 

You can add a bunch of things to your enum like a constructor, methods, 
variables, and sometliing called a consiantHspecific class body. They're 
not common, but you rrught run into them: 



public class HfjEnum ( 

enum Names { 

JERRY r'lead guitar ) { piiblic String sings () { 
return ^'plaintively"; } 

}. 

BOBBY (''rhythm guitar") { public String sings () f 

return "hoarsely"; } 

PHIL ("bass") ; 

private String instrument; 



Names (String instrument) { 

this . instrument = instrument; 

) 

public String getlnstrument () ( 

return this . instrument; 

} 

public String sings () { 
return "occasionally"; 



ov\6e -fijv- ea^K declared vaW 



Voul) sec these ^etl^^s bcir^g djllej ^>ror. "^i^O" 



) 



public static void main (String [] args) { 
for {Names n : Names . values () ) { 

System. out .print (n) ; 

System, out .print (", instrument; n . getlnstrument ()) ; „. s\^<iwrk- 
System.out .println ('\ sings: " + n.singsO); ^ 



,KitV. -.s tY?'»t^»7 " ^ 



Noilde t>^^i tKc basid ^,^gO" 
rweihod is ohly tailed v^hcn tKe 
«riUfh value Kas »io dohstarkt- 
spedi^it dlais body. 



%java HfjEnum 

JEEU^Y, instrument: lead guitar, sings: plaintively 
BOBBY, instrument: rhythm guitar, sings: hoarsely 
PHIL, instrument: bass, sings: occasionally 

% 
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A Long Trip Home 




Captain Byte of the FlatJand starship 'Traverser" had received an urgent. Top Secret transmission 
from headquarters. The message contained 30 heavily encrypted navigational codes that the 
Traverser would need to successfuJiy plot a course home through enemy sectors. The enemy 
Hackarians, from a neighboring galaxy, had devised a devilish code-scrambling ray that wa5 capable 
of creating bogus objects on the heap of the Traverser's only navigational computer In 
addition, the alien ray could aher valid reference variables so that they referred to these 
bogus objects. The onjy defense the Traverser crew had against this evil Hackarian ray was 
to run an inline virus checker which could be imbedded into the Traverser's stale of the art 
Java 1 A code. 

Captain Byte gave Ensign Smith the following programming instructions to process the critical 
navigational codes: 

*Tut the first five codes in an array of type ParsecKey. Put the last 25 codes in a five by five, two 
dimensional array of type QuadrantKey. Pass these two arrays into the plotCourseQ method of the 
public final class ShipNavigation. Once the course object is returned run the inline virus checker 
against all the programs reference variables and then run the NavSim program and bring me the 
results/' 

A few minutes later Ensign Smith returned with the NavSim output. '"NavSim output ready for 
review, sir", declared Ensign Smith. 'Tine", replied the Captain^ *Tlease review your work". 'Tes 
sir!", responded the Ensign, "First I declared and constructed an array of type ParsecKey with the 
following code; ParsecKey [] p = new ParsecKey [5]; , next I declared and constructed an array 
of type QuadrantKey with the following code: QuadrantKey Q G q = new QuadrantKey [5] [5]; . 
Next, I loaded the first 5 codes into the ParsecKey array using a 'for' loop, and then I loaded the last 
25 codes into the QuadrantKey. array using nested 'for* loops. Next, I ran the virus checker against 
all 32 reference variables, 1 for the ParsecKey array, and 5 for its elements, 1 for the QuadrantKey 
array, and 25 for its elements. Once the virus check returned with no viruses detected, 1 ran the 
NavSim program and re^ran the virus checker, just to be safe. . . Sir ! 

Captain Byte gave the Ensign a cool, long stare and said calmly, ''Ensign, you are confined to 
quarters for endangering the safety of this ship, I don't want to see your face on this bridge again 
until you have properly learned your Java! Lieutenant Boolean, take over for the Ensign and do this 
job correctly!" 



Why did the captain confine the Ensign to his quarters? 
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Captain Byte knew that in Java, muItadiraensionaJ arrays are actu- 
ally arrays of arrays. The five by five QuadrantKey array 'q\ would 
actually need a total of 31 reference variables to be able to access 
all of its components: 

1 - reference variable for 'q* 

5 - reference variables for q[0] - q[4] 

25 - reference variables for q[0] [0] - q[41 [4] 

The ensign had forgotten the reference variables for the five one 
dimensional arrays embedded in the 'q' array Any of those five 
reference variables could have been corrupted by the Hackarian 
ray and the ensign *s test would never reveal the problem. 
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